| 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 |
| Message-ID: | 20191125075507.GH99720@paquier.xyz |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| 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.
--
Michael
| 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" ? |
| 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 |