From: | Jürgen Purtz <juergen(at)purtz(dot)de> |
---|---|
To: | pgsql-docs(at)lists(dot)postgresql(dot)org |
Cc: | Corey Huinker <corey(dot)huinker(at)gmail(dot)com>, Liudmila Mantrova <l(dot)mantrova(at)gmail(dot)com> |
Subject: | Re: Shrinking SVG (Again) |
Date: | 2020-02-15 08:19:32 |
Message-ID: | 3f502222-487a-1937-9a77-0181bf72cd8b@purtz.de |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
> So now we have two glossaries being proposed [1] [2], and they don't
> have much in common with each other. What to do now? If we can get the
> authors to agree on what patch to submit, we can move forward.
>
> I suggest to make a glossary be 0001, and then the other patches can be
> 0002 or further.
Yes, we should work on the glossary with priority because other things
depend on it, not only the explanation of figures.
The two proposals differs in their nature: [1] is focused on PG-specific
terms like WAL, Background Writer, Background Worker, ... and such terms
that are broadly used but may differ from the meaning in other DBMS like
Segment or Data Dictionary. It's only a starting point. Currently it
misses the terms of important features like MVCC, Backup, Replication,
... . [2] also contains fundamental terms but is focused on universal
terms of the DBMS community like SELECT, Null, Rollback, ... .
It's important to check, whether the existing documentation starts with
something like "A <glossary-term> is a ...". In my opinion such
redundancies aren't a problem as long as they don't contradict each
other. On the contrary, I support this approach.
J. Purtz
From | Date | Subject | |
---|---|---|---|
Next Message | Alexander Lakhin | 2020-02-15 09:09:09 | Re: PDF doc build is broken on recent Fedora |
Previous Message | Peter Geoghegan | 2020-02-15 02:39:34 | Re: Duplicating website's formatting in local doc builds |