Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1iz0zE-0007f1-UO
	for pgsql-docs@arkaria.postgresql.org; Tue, 04 Feb 2020 16:23:41 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.89)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1iz0zD-0002OB-F9
	for pgsql-docs@arkaria.postgresql.org; Tue, 04 Feb 2020 16:23:39 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <sfrost@tamriel.snowman.net>)
	id 1iz0zD-0002O3-7M
	for pgsql-docs@lists.postgresql.org; Tue, 04 Feb 2020 16:23:39 +0000
Received: from tamriel.snowman.net ([2001:470:e38f::11])
	by magus.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <sfrost@tamriel.snowman.net>)
	id 1iz0zA-0005ZW-50
	for pgsql-docs@lists.postgresql.org; Tue, 04 Feb 2020 16:23:38 +0000
Received: by tamriel.snowman.net (Postfix, from userid 1000)
	id 633FC5F7AB; Tue,  4 Feb 2020 11:23:36 -0500 (EST)
Date: Tue, 4 Feb 2020 11:23:36 -0500
From: Stephen Frost <sfrost@snowman.net>
To: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: "Jonathan S. Katz" <jkatz@postgresql.org>,
	Bruce Momjian <bruce@momjian.us>, R Ransbottom <rirans@comcast.net>,
	Ian Barwick <ian.barwick@2ndquadrant.com>,
	Laurenz Albe <laurenz.albe@cybertec.at>,
	pgsql-docs@lists.postgresql.org
Subject: Re: Documentation: 21.5. Default Roles
Message-ID: <20200204162336.GR3195@tamriel.snowman.net>
References: <3b1f6cb3-4a6c-fff7-59ae-b8ce0a9866d8@postgresql.org>
 <20200203212510.GA16484@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="WEuxlb/T9My9hNez"
Content-Disposition: inline
In-Reply-To: <20200203212510.GA16484@alvherre.pgsql>
User-Agent: Mutt/1.5.24 (2015-08-30)
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Precedence: bulk


--WEuxlb/T9My9hNez
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Greetings,

* Alvaro Herrera (alvherre@2ndquadrant.com) wrote:
> On 2020-Feb-03, Jonathan S. Katz wrote:
>=20
> > 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.
>=20
> 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.

I'm a bit confused as it sounded like having the redirect wouldn't be
easy to do..  I also agree that keeping the URL the same as today but
changing that URL to be talking about 'predefined roles' would be quite
confusing.

Having some kind of landing page with the existing URL that had a link
for people to click on to get to the new URL seems like it would
possibly work.  I'd be happier with having that done in master and
keeping the back-branches as-is, since I don't really like the idea that
we're retroactively renaming a feature in our existing releases.

That said, if we at least have the landing page then at least people
will be less likely to be confused.

Thanks,

Stephen

--WEuxlb/T9My9hNez
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQIcBAEBCgAGBQJeOZqIAAoJEO1sijiDR2RV8oEQAL7nEMRgdInMxBhSR6WcmpJ5
KZ+feBc2Y61cfRd68bmV10j037Iq6Vu2rINiVTD3yz4WX0BfBDF+WVSu3kZ5hMNf
+vJXGdTpfxKRj+juETzrJp0mDcIOxzYhpiFRfCLeBl39GAtRbyvcHHmsu90AXBms
LSH2VEaqexgsZQgyRaFEK4qizaFdSnSIBvmZ8OXEnJoXZJV/eZHnQ51ZlShQvLkJ
nVuMbVV6QkXjpwH/oBiRkLfeoVaFd01jg9bJo4w6pM/8HUuLhkxcs5G+hCFXCMQU
+68+C9clshOWl3KctT0Xuoehj9p/hiMHJisEn1G4/9tqsJ7+LlOaNJanG5zF0q3L
H2FvLD5NWrn1SXB3UkmO/05SVoXepa3ceqfiGbnzDG00WoMmZP/lb75jJYtU3d3h
kTl4+uAQw2VcQ73ePGYxdZMJpy/7MvrnbfM0CauxSlc65zAhoBd/In3WLibxkvch
9iJG+Pz1CwqRPNDtVlMTnNsoxykW6aGC5QPDizKHAU06oX1Cyk1WLNZ7Vv6R3gv7
QQRfASlZUdkRZBVNcutn6PWKlL3S8qM5kmy1PUdxOc/7dgrYp7D1vrG2IPGY+tCQ
OMTVlEgTk1AgR4ayvnAHwtz+l/QUKsmq+Hfz3efRMzTXjT8kwLdMoPH1lB8Ky4Zy
S9SeBfZ39tp38e8lEj2I
=QDg4
-----END PGP SIGNATURE-----

--WEuxlb/T9My9hNez--