Re: Add A Glossary

Jürgen Purtz <juergen@purtz.de>

From: Jürgen Purtz <juergen@purtz.de>
To: Corey Huinker <corey.huinker@gmail.com>
Cc: Justin Pryzby <pryzby@telsasoft.com>, Alvaro Herrera <alvherre@2ndquadrant.com>, Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org, Fabien COELHO <coelho@cri.ensmp.fr>, Michael Paquier <michael@paquier.xyz>
Date: 2020-04-01T07:34:56Z
Lists: pgsql-hackers, pgsql-docs
On 31.03.20 20:07, Justin Pryzby wrote:
> On Mon, Mar 30, 2020 at 01:10:19PM -0400, Corey Huinker wrote:
>> +   <glossentry id="glossary-aggregating">
>> +    <glossterm>Aggregating</glossterm>
>> +    <glossdef>
>> +     <para>
>> +      The act of combining a collection of data (input) values into
>> +      a single output value, which may not be of the same type as the
>> +      input values.
> I think we maybe already tried to address this ; but could we define a noun
> form ?  But not "aggregate" since it's the same word as the verb form.  I think
> it would maybe be best to merge with "aggregate function", below.

Yes, combine the two. Or remove "aggregating" at all.


> + <glossentry id="glossary-log-writer">
>> +    <glossterm>Log Writer</glossterm>
>> +    <glossdef>
>> +     <para>
>> +      If activated and parameterized, the
> I still don't know what parameterized means here.

Remove "and parameterized". The Log Writer always has (default) parameters.


Every thing else is ok for me.

Kind regards, Jürgen



Commits

  1. Glossary: Add term "base backup"

  2. Minor glossary tweaks

  3. Adjust some glossary terms

  4. Fix more typos and grammar problems in the glossary

  5. Review of the glossary

  6. Add a glossary to the documentation