Date: Sat, 4 Apr 2020 08:55:05 +0200 (CEST)
From: Fabien COELHO <coelho@cri.ensmp.fr>
To: Justin Pryzby <pryzby@telsasoft.com>
cc: Alvaro Herrera <alvherre@2ndquadrant.com>, Erik Rijkers <er@xs4all.nl>,
    Corey Huinker <corey.huinker@gmail.com>,
    =?ISO-8859-15?Q?J=FCrgen_Purtz?= <juergen@purtz.de>,
    Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org,
    Michael Paquier <michael@paquier.xyz>
Subject: Re: Add A Glossary
In-Reply-To: <20200403210120.GA12283@telsasoft.com>
Message-ID: <alpine.DEB.2.21.2004040832220.16227@pseudo>
References: <7b9b469e804777ac9df4d37716db935e@xs4all.nl>
 <20200403205143.GA7961@alvherre.pgsql> <20200403210120.GA12283@telsasoft.com>
User-Agent: Alpine 2.21 (DEB 202 2017-01-01)
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII; format=flowed
Precedence: bulk


> BTW it's now visible at:
> https://www.postgresql.org/docs/devel/glossary.html

Awesome! Linking beetween defs and to relevant sections is great.

BTW, I'm in favor of "an SQL" because I pronounce it "ess-kew-el", but I 
guess that people who say "sequel" would prefer "a SQL". Failing that, I'm 
fine with some heterogeneity, life is diverse!

ISTM that occurrences of these words elsewhere in the documentation should 
link to the glossary definitions?

As the definitions are short and to the point, maybe the HTML display 
could (also) "hover" the definitions when the mouse passes over the word, 
using the "title" attribute?

"ACID" does not appear as an entry, nor in the acronyms sections. Also no 
DCL, although DML & DDL are in acronyms.

Entries could link to relevant wikipedia pages, like the acronyms section 
does?

-- 
Fabien.