Re: client auth docs seem to have devolved

Поиск
Список
Период
Сортировка
От Magnus Hagander
Тема Re: client auth docs seem to have devolved
Дата
Msg-id CABUevEzOcEBRLug3gTpAEhvSRjqyNLsk7QY70JbM-OStj=5cYA@mail.gmail.com
обсуждение исходный текст
Ответ на Re: client auth docs seem to have devolved  (Dave Cramer <davecramer@gmail.com>)
Ответы Re: client auth docs seem to have devolved  (Tom Lane <tgl@sss.pgh.pa.us>)
Re: client auth docs seem to have devolved  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-hackers
On Tue, Dec 17, 2019 at 1:02 PM Dave Cramer <davecramer@gmail.com> wrote:
On Tue, 17 Dec 2019 at 06:53, Magnus Hagander <magnus@hagander.net> wrote:
On Tue, Dec 17, 2019 at 12:43 PM Dave Cramer <davecramer@gmail.com> 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:


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?

--

В списке pgsql-hackers по дате отправления:

Предыдущее
От: Dave Cramer
Дата:
Сообщение: Re: client auth docs seem to have devolved
Следующее
От: Amit Khandekar
Дата:
Сообщение: Re: logical decoding : exceeded maxAllocatedDescs for .spill files