From: =?UTF-8?Q?J=c3=bcrgen_Purtz?= <juergen@purtz.de>
Subject: Re: Add A Glossary
To: Corey Huinker <corey.huinker@gmail.com>,
 Alvaro Herrera <alvherre@2ndquadrant.com>,
 Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org,
 Fabien COELHO <coelho@cri.ensmp.fr>, Michael Paquier <michael@paquier.xyz>,
 Justin Pryzby <pryzby@telsasoft.com>
References: 
 <CADkLM=dTFNCnx+bdoVCVbAn3v8ihvgUh-dQpin4ngrx=RMykFA@mail.gmail.com>
 <20200320175144.GA20645@alvherre.pgsql>
 <CADkLM=dZ=7Yt37y3m7me=gUP9kLO+Mf6JP4FDFYCMsXzARY8sw@mail.gmail.com>
Message-ID: <8801a7ba-2ce9-2132-06bd-e480810ad59b@purtz.de>
Date: Fri, 20 Mar 2020 23:32:17 +0100
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
 Thunderbird/68.4.1
MIME-Version: 1.0
In-Reply-To: 
 <CADkLM=dZ=7Yt37y3m7me=gUP9kLO+Mf6JP4FDFYCMsXzARY8sw@mail.gmail.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Content-Language: en-US
Precedence: bulk

man pages: Sorry, if I confused someone with my poor English. I just 
want to express in my 'offline' mail that we don't have to worry about 
man page generation. The patch doesn't affect files in the /ref 
subdirectory from where man pages are created.

review process: Yes, it will be time-consumptive and it may be a hard 
job because of a) the patch has multiple authors with divergent writing 
styles and b) the terms affect different fundamental issues: SQL basics 
and PG basics. Concerning PG basics in the past we used a wide range of 
similar terms with different meanings as well as different terms for the 
same matter - within our documentation as well as in secondary 
publications. The terms "backend server" / "instance" are such an 
example and there shall be a clear decision in favor of one of the two. 
Presumably we will see more discussions about the question which one is 
the preferred term (remember the discussion concerning the terms 
master/slave, primary/secondary some weeks ago).

ongoing: Intermediate questions for clarifications are welcome.


Kind regards, Jürgen