Re: Add A Glossary

Erik Rijkers <er@xs4all.nl>

From: Erik Rijkers <er@xs4all.nl>
To: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: Jürgen Purtz <juergen@purtz.de>, Laurenz Albe <laurenz.albe@cybertec.at>, Fabien COELHO <coelho@cri.ensmp.fr>, Peter Eisentraut <peter.eisentraut@2ndquadrant.com>, Corey Huinker <corey.huinker@gmail.com>, Justin Pryzby <pryzby@telsasoft.com>, Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org, Michael Paquier <michael@paquier.xyz>
Date: 2020-05-17T09:08:02Z
Lists: pgsql-hackers, pgsql-docs
On 2020-05-17 08:51, Alvaro Herrera wrote:
> On 2020-May-17, Jürgen Purtz wrote:
> 
>> On 15.05.20 02:00, Alvaro Herrera wrote:
>> > Thanks everybody.  I have compiled together all the suggestions and the
>> >
>> > * I changed "instance", and made "cluster" be mostly a synonym of that.
>> In my understanding, "instance" and "cluster" should be different 
>> things,
> 
> I don't think that's the general understanding of those terms.  For all
> I know, they *are* synonyms, and there's no specific term for "the
> fluctuating objects" as you call them.  The instance is either running
> (in which case there are processes and RAM) or it isn't.

For what it's worth, I've also always understood 'instance' as 'a 
running database'.  I admit it might be a left-over from my oracle 
years:

   
https://docs.oracle.com/cd/E11882_01/server.112/e40540/startup.htm#CNCPT601

There, 'instance' clearly refers to a running database.  When that 
database is stopped, it ceases to be an instance.  I've always 
understood this to be the same for the PostgreSQL 'instance'.  Once 
stopped, it is no longer an instance, but it is, of course, still a 
cluster.

I know, we don't have to do the same as Oracle, but clearly it's going 
to be an ongoing source of misunderstanding if we define such a 
high-level term differently.

Erik Rijkers



Commits

  1. Glossary: Add term "base backup"

  2. Minor glossary tweaks

  3. Adjust some glossary terms

  4. Fix more typos and grammar problems in the glossary

  5. Review of the glossary

  6. Add a glossary to the documentation