Re: Shrinking SVG (Again)

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

In response to

Browse pgsql-docs by date

  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