public inbox for [email protected]
help / color / mirror / Atom feedFrom: Magnus Hagander <[email protected]>
To: Dave Cramer <[email protected]>
To: Peter Eisentraut <[email protected]>
Cc: PostgreSQL-development <[email protected]>
Cc: PostgreSQL WWW <[email protected]>
Subject: Re: client auth docs seem to have devolved
Date: Tue, 17 Dec 2019 13:06:57 +0100
Message-ID: <CABUevEzOcEBRLug3gTpAEhvSRjqyNLsk7QY70JbM-OStj=5cYA@mail.gmail.com> (raw)
In-Reply-To: <CADK3HH++WrDDfE2q9+qpuaaq-SJfbvC5csP-qFtf_JuTpffeEw@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>
On Tue, Dec 17, 2019 at 1:02 PM Dave Cramer <[email protected]> wrote:
> On Tue, 17 Dec 2019 at 06:53, Magnus Hagander <[email protected]> wrote:
>
>> On Tue, Dec 17, 2019 at 12:43 PM Dave Cramer <[email protected]>
>> wrote:
>>
>>> While following an old link to
>>> https://www.postgresql.org/docs/10/auth-methods.html
>>>
>>> I see a list of links to authentication methods. However:
>>>
>>> When I hit the current version
>>> https://www.postgresql.org/docs/current/auth-methods.html
>>>
>>> There are absolutely no links...
>>>
>>>
>> That's because the structure of the docs changed. You need to hit "up",
>> which will take you to
>> https://www.postgresql.org/docs/current/client-authentication.html,
>> which now has the list of links. Note how the different methods used to be
>> 20.3.x, and are now directly listed as 20.y.
>>
>> I'm unsure if that was intentional in the upstream docs, but that's what
>> makes the website behave like it does.
>>
>
> Fair enough but
>
> 20.3. Authentication Methods
> The following sections describe the authentication methods in more detail.
>
> certainly is misleading.
>
>
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?
--
Magnus Hagander
Me: https://www.hagander.net/ <http://www.hagander.net/;
Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/;
view thread (11+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected], [email protected], [email protected]
Subject: Re: client auth docs seem to have devolved
In-Reply-To: <CABUevEzOcEBRLug3gTpAEhvSRjqyNLsk7QY70JbM-OStj=5cYA@mail.gmail.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox