Date: Mon, 3 Feb 2020 18:25:10 -0300
From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: "Jonathan S. Katz" <jkatz@postgresql.org>
Cc: Bruce Momjian <bruce@momjian.us>, R Ransbottom <rirans@comcast.net>,
	Ian Barwick <ian.barwick@2ndquadrant.com>,
	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: <20200203212510.GA16484@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <3b1f6cb3-4a6c-fff7-59ae-b8ce0a9866d8@postgresql.org>
User-Agent: Mutt/1.10.1 (2018-07-13)
Precedence: bulk

On 2020-Feb-03, Jonathan S. Katz wrote:

> So, if there was something done to redirect people from specific
> deprecated documentation pages historically, it was before my time. Most
> of the redirects have been as general purposes ones (e.g. /docs/12), the
> rules we put in for getting rid of "static", and the release notes,
> which still receives some negative feedback towards it for different
> reasons (though I think overall the effort was well-received). Anyway,
> if we had a redirect in place, I'd want us to do it well.

I +1 changing the title and +1 having the redirect.  That said, I think
people landing in a page titled "predefined roles" when they're looking
for a page titled "default roles" would be quite confused for a while
and perhaps continue to search for the page they think they're looking
for.  (I know, it has happened to me.)  I suggest we add a very short
paragraph --maybe a <note>-- to the effect that feature-X used to be
called feature-Y, immediately following the section title.

-- 
Álvaro Herrera                https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services