Re: Add A Glossary

From: Corey Huinker <corey(dot)huinker(at)gmail(dot)com>
To: Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, Justin Pryzby <pryzby(at)telsasoft(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-04-02 19:40:44
Message-ID: CADkLM=eP6+QgeaPQfvoLB+DzXEg798AbnMq-fc9TzHCgFzHtJQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Thu, Apr 2, 2020 at 8:44 AM Jürgen Purtz <juergen(at)purtz(dot)de> wrote:

> +1 and many thanks to Alvaros edits.
>
>
I did some of the grunt work Alvaro alluded to in v6, and the results are
attached and they build, which means there are no invalid links.

Notes:
* no definition wordings were changed
* added a linkend to all remaining glossterms that do not immediately
follow a glossentry
* renamed id glossary-temporary-tables to glossary-temporary-table
* temporarily re-added an id for glossary-row as we have many references to
that. unsure if we should use the term Tuple in all those places or say Row
while linking to glossary-tuple, or something else
* temporarily re-added an id for glossary-segment, glossary-wal-segment,
glossary-analytic-function, as those were also referenced and will need
similar decisions made
* added a stub entry for glossary-unique-index, unsure if it should have a
definition on it's own, or we split it into unique and index.
* I noticed several cases where a glossterm is used twice in a definition,
but didn't de-term them
* I'm curious about how we should tag a term when using it in its own
definition. same as anywhere else?

Attachment Content-Type Size
0001-glossary-v7.patch text/x-patch 61.7 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alvaro Herrera 2020-04-02 22:09:32 Re: Add A Glossary
Previous Message Jürgen Purtz 2020-04-02 12:44:26 Re: Add A Glossary

Browse pgsql-hackers by date

  From Date Subject
Next Message Robert Haas 2020-04-02 19:42:48 Re: backup manifests
Previous Message David Steele 2020-04-02 19:26:15 Re: backup manifests