Date: Mon, 20 Jan 2020 11:02:58 -0500
From: Bruce Momjian <bruce@momjian.us>
To: Ian Barwick <ian.barwick@2ndquadrant.com>
Cc: R Ransbottom <rirans@comcast.net>, Stephen Frost <sfrost@snowman.net>,
	Laurenz Albe <laurenz.albe@cybertec.at>,
	pgsql-docs@lists.postgresql.org
Subject: Re: Documentation: 21.5. Default Roles
Message-ID: <20200120160258.GA28095@momjian.us>
References: <157742545062.1149.11052653770497832538@wrigleys.postgresql.org>
 <20191227171654.GA2992@momjian.us>
 <8c2f4f1b90c993c8c6338b978a78a9ebbcd1c934.camel@cybertec.at>
 <20200114181331.GB10430@momjian.us>
 <20200114194502.GX3195@tamriel.snowman.net>
 <20200119035648.3k4d3erobborxwv3@rat.local>
 <957c35e3-8023-ebe6-3b51-3a620b66ae82@2ndquadrant.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <957c35e3-8023-ebe6-3b51-3a620b66ae82@2ndquadrant.com>
User-Agent: Mutt/1.10.1 (2018-07-13)
Precedence: bulk

On Mon, Jan 20, 2020 at 12:23:48PM +0900, Ian Barwick wrote:
> > I would hope to find correct documentation somewhere--that somewhere
> > should be Postgresql's own documentation.
> 
> Indeed, however it's important that the PostgreSQL documentation remains
> stable for released versions.
> 
> As-is, the current patch set would result in the term "default role(s)"
> disappearing from the documentation in the next minor release, which is
> bound to cause confusion for anyone searching the documentation for the
> term they're familiar with (unless they happen to be reading this thread
> or following the git commit log). Cue cries of "OMG Postgres removed a
> feature in a minor release!!!?!!".
> 
> And as Stephen mentions, it will break a lot of secondary documentation -
> not just blogs but things like internal training  materials etc.
> 
> If this change is made (which I'm personally not against), then it should be
> only from PostgreSQL 13. For 9.6 ~ 12, IMHO it would be better to tweak the
> existing documentation to somehow mention that "default roles" should be
> thought of as "prefined roles", and note they will be called this from Pg13.

Usually when I apply "wording" doc patches to head only, someone
complains that it should be backpatched, so I did that in this case.  If
we want to change that idea, we need to agree on the criteria.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +