Re: Add A Glossary

From: Justin Pryzby <pryzby(at)telsasoft(dot)com>
To: Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: Corey Huinker <corey(dot)huinker(at)gmail(dot)com>, Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, 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-31 17:58:45
Message-ID: 20200331175845.GF14618@telsasoft.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Tue, Mar 31, 2020 at 04:13:00PM +0200, Jürgen Purtz wrote:
> Please find some minor suggestions in the attachment. They are based on
> Corey's last patch 0001-glossary-v4.patch.

> @@ -220,7 +220,7 @@
> Record</glossterm>s to the file system and creates a special
> checkpoint record. This process is initiated when predefined
> conditions are met, such as a specified amount of time has passed, or
> - a certain volume of records have been collected.
> + a certain volume of records has been collected.

I think you're correct in that "volume" is singular. But I think "collected"
is the wrong world. I suggested "written".

> <para>
> - One of the <acronym>ACID</acronym> properties. This means that concurrently running
> + One of the <acronym>ACID</acronym> properties. This means that concurrently running

These could maybe say "required" or "essential" >ACID< properties

> <para>
> + In reference to a <glossterm>Table</glossterm>:
> A <glossterm>Table</glossterm> that can be queried directly,

Maybe: "In reference to a >Relation<: A table which can be queried directly,"

> table in the collection.
> </para>
> <para>
> - When referring to an <glossterm>Analytic</glossterm>
> - <glossterm>Function</glossterm>: a partition is a definition
> - that identifies which neighboring
> + In reference to a <glossterm>Analytic Function</glossterm>:
s/a/an/

> @@ -1333,7 +1334,8 @@
> <glossdef>
> <para>
> The condition of having no duplicate values in the same
> - <glossterm>Relation</glossterm>. Often used in the concept of
> + <glossterm>Column</glossterm> of a <glossterm>Relation</glossterm>.
> + Often used in the concept of

s/concept/context/, but I said that before, so maybe it was rejected.

--
Justin

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Justin Pryzby 2020-03-31 18:07:40 Re: Add A Glossary
Previous Message Jürgen Purtz 2020-03-31 14:13:00 Re: Add A Glossary

Browse pgsql-hackers by date

  From Date Subject
Next Message Justin Pryzby 2020-03-31 18:07:40 Re: Add A Glossary
Previous Message Tom Lane 2020-03-31 17:58:24 Re: [PATCH] Incremental sort (was: PoC: Partial sort)