From: Tom Lane <tgl@sss.pgh.pa.us>
To: Magnus Hagander <magnus@hagander.net>
cc: Dave Cramer <davecramer@gmail.com>,
        Peter Eisentraut <peter.eisentraut@2ndquadrant.com>,
        PostgreSQL-development <pgsql-hackers@postgresql.org>,
        PostgreSQL WWW <pgsql-www@postgresql.org>
Subject: Re: client auth docs seem to have devolved
In-reply-to: 
 <CABUevEzOcEBRLug3gTpAEhvSRjqyNLsk7QY70JbM-OStj=5cYA@mail.gmail.com>
References: 
 <CADK3HH+xQLhcPgg=kWqfogtXGGZr-JdSo=x=WQC0PkAVyxUWyQ@mail.gmail.com>
 <CABUevEzWhRtMVSOyM=YkpMR9FZV3E3w2OjcFScKAjHbu3=io7g@mail.gmail.com>
 <CADK3HH++WrDDfE2q9+qpuaaq-SJfbvC5csP-qFtf_JuTpffeEw@mail.gmail.com>
 <CABUevEzOcEBRLug3gTpAEhvSRjqyNLsk7QY70JbM-OStj=5cYA@mail.gmail.com>
Comments: In-reply-to Magnus Hagander <magnus@hagander.net>
	message dated "Tue, 17 Dec 2019 13:06:57 +0100"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <13335.1576598463.1@sss.pgh.pa.us>
Date: Tue, 17 Dec 2019 11:01:03 -0500
Message-ID: <13336.1576598463@sss.pgh.pa.us>
Precedence: bulk

Magnus Hagander <magnus@hagander.net> writes:
> This was changed by Peter in
> commit 56811e57323faa453947eb82f007e323a952e1a1 along with the
> restructuring. It used to say "the following subsections". So techically I
> think that change is correct, but that doesn't necessarily make it helpful.

> But based on how it actually renders, since that section doesn't contain
> any actual useful info, we should perhaps just remove section 20.3
> completely. Peter, thoughts?

Then, URLs pointing to that page (such as Dave evidently has bookmarked)
would break entirely, which doesn't seem like an improvement.

I suggest changing the sect1's contents to be a list of available auth
methods, linked to their subsections.  That would provide approximately
the same quality-of-use as the subsection TOC that used to be there.

			regards, tom lane