Re: Add A Glossary

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>
Cc: Corey Huinker <corey(dot)huinker(at)gmail(dot)com>, pgsql-hackers(at)postgresql(dot)org
Subject: Re: Add A Glossary
Date: 2019-11-25 07:55:07
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs pgsql-hackers

On Sat, Nov 09, 2019 at 09:19:16AM +0100, Fabien COELHO wrote:
> On principle, I'm fine with having a glossary, i.e. word definitions, which
> are expected to be rather stable in the long run.
> I'm wondering whether the effort would not be made redundant by other
> on-line effort such as wikipedia, wiktionary, stackoverflow, standards,
> whatever.
> When explaining something, the teacher I am usually provides some level of
> example. This may or may not be appropriate there.

That's exactly a good reason for being a reviewer here. You have
quite some insight here.

> I'd consider making SQL keywords uppercase.
> Developing that is a significant undertaking. Do we have the available
> energy?

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 response to


Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2019-11-25 12:05:17 Example not producing shown output
Previous Message Michael Paquier 2019-11-25 04:01:08 Re: documentation clarifications for "alter sequence" ?

Browse pgsql-hackers by date

  From Date Subject
Next Message Michael Paquier 2019-11-25 07:58:35 Re: Add Change Badges to documentation
Previous Message Michael Paquier 2019-11-25 07:46:38 Re: [PATCH] Fix Proposal - Deadlock Issue in Single User Mode When IO Failure Occurs