Date: Tue, 21 Jan 2020 10:09:22 -0500
From: Bruce Momjian <bruce@momjian.us>
To: Laurenz Albe <laurenz.albe@cybertec.at>
Cc: Simon Riggs <simon@2ndquadrant.com>,
	Ian Barwick <ian.barwick@2ndquadrant.com>,
	R Ransbottom <rirans@comcast.net>,
	Stephen Frost <sfrost@snowman.net>, pgsql-docs@lists.postgresql.org
Subject: Re: Documentation: 21.5. Default Roles
Message-ID: <20200121150922.GB7084@momjian.us>
References: <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>
 <20200120160258.GA28095@momjian.us>
 <CANP8+jJ7OcuGTgvk+S-fvWSj_KPjemV6vvhamj1g9zHuQx7a2A@mail.gmail.com>
 <20200120221357.GA28881@momjian.us>
 <dd9d5020fce3638efb69571f6f5577cbc82a8175.camel@cybertec.at>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <dd9d5020fce3638efb69571f6f5577cbc82a8175.camel@cybertec.at>
User-Agent: Mutt/1.10.1 (2018-07-13)
Precedence: bulk

On Tue, Jan 21, 2020 at 10:06:43AM +0100, Laurenz Albe wrote:
> On Mon, 2020-01-20 at 17:13 -0500, Bruce Momjian wrote:
> > Well, I am renaming the documentation label for the feature.  Is that
> > different than wording?  I guess I can see that.  If everyone agrees I
> > can revert the backpatch, but I don't want to do that if other people
> > are going to say this should be backpatched.
> 
> I for one think that it should be backpatched, as long as the
> old link keeps working.

I looked at that option.  If the section was a hash reference,
"#section_name", we could just add another hash, but in this case the
section name is part of the file name:

	https://www.postgresql.org/docs/12/default-roles.html

We can make that work in a backward-compatible way by changing the
displayed section title, but not the file name.  I am not sure if that
would confuse people though.  We could also add a redirect at the web
server level, but then you have to start to wonder whether the entire
rename clarification is worth it for back branches.

-- 
  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 +