Re: Add A Glossary

From: Corey Huinker <corey(dot)huinker(at)gmail(dot)com>
To: pgsql-hackers(at)postgresql(dot)org
Cc: Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>, Roger Harkavy <rogerharkavy(at)gmail(dot)com>, juergen(at)purtz(dot)de, Michael Paquier <michael(at)paquier(dot)xyz>
Subject: Re: Add A Glossary
Date: 2020-03-10 15:37:41
Message-ID: CADkLM=cQ1D4pA8GmBBftg7R+qQnJDHEgLvmxG4HBV8F6r4eiKg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

This latest version is an attempt at merging the work of Jürgen Purtz into
what I had posted earlier. There was relatively little overlap in the terms
we had chosen to define.

Each glossary definition now has a reference id (good idea Jürgen), the
form of which is "glossary-term". So we can link to the glossary from
outside if we so choose.

I encourage everyone to read the definitions, and suggest fixes to any
inaccuracies or awkward phrasings. Mostly, though, I'm seeking feedback on
the structure itself, and hoping to get that committed.

On Tue, Feb 11, 2020 at 11:22 PM Corey Huinker <corey(dot)huinker(at)gmail(dot)com>
wrote:

> It seems like this could be a good idea, still the patch has been
>> waiting on his author for more than two weeks now, so I have marked it
>> as returned with feedback.
>>
>
> In light of feedback, I enlisted the help of an actual technical writer
> (Roger Harkavy, CCed) and we eventually found the time to take a second
> pass at this.
>
> Attached is a revised patch.
>
>

Attachment Content-Type Size
0001-add-glossary-page.patch text/x-patch 47.3 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Roger Harkavy 2020-03-11 13:40:45 Re: Add A Glossary
Previous Message PG Doc comments form 2020-03-10 10:26:51 Inherited tables cannot be partitioned (version 12.0)

Browse pgsql-hackers by date

  From Date Subject
Next Message Alvaro Herrera 2020-03-10 15:39:53 Re: [Patch] pg_rewind: options to use restore_command from recovery.conf or command line
Previous Message Alexander Korotkov 2020-03-10 15:30:06 Re: Improve search for missing parent downlinks in amcheck