Re: Add A Glossary

From: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
To: Corey Huinker <corey(dot)huinker(at)gmail(dot)com>
Cc: Jürgen Purtz <juergen(at)purtz(dot)de>, Roger Harkavy <rogerharkavy(at)gmail(dot)com>, pgsql-hackers(at)postgresql(dot)org, Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>, Michael Paquier <michael(at)paquier(dot)xyz>
Subject: Re: Add A Glossary
Date: 2020-03-20 00:11:22
Message-ID: 20200320001122.GA19602@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

I gave this a look. I first reformatted it so I could read it; that's
0001. Second I changed all the long <link> items into <xref>s, which
are shorter and don't have to repeat the title of the refered to page.
(Of course, this changes the link to be in the same style as every other
link in our documentation; some people don't like it. But it's our
style.)

There are some mistakes. "Tupple" is most glaring one -- not just the
typo but also the fact that it goes to sql-revoke. A few definitions
we'll want to modify. Nothing too big. In general I like this work and
I think we should have it in pg13.

Please bikeshed the definition of your favorite term, and suggest what
other terms to add. No pointing out of mere typos yet, please.

I think we should have the terms Consistency, Isolation, Durability.

--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

Attachment Content-Type Size
0001-glossary.patch text/x-diff 52.2 KB
0002-Change-all-For-more-info-see-X-links-to-xref-style.patch text/x-diff 11.5 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Corey Huinker 2020-03-20 01:41:54 Re: Add A Glossary
Previous Message Bruce Momjian 2020-03-19 20:56:46 Re: explanation for random_page_cost is outdated

Browse pgsql-hackers by date

  From Date Subject
Next Message Justin Pryzby 2020-03-20 00:29:09 Re: error context for vacuum to include block number
Previous Message James Coleman 2020-03-20 00:04:43 Re: improve transparency of bitmap-only heap scans