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 ) id 1ihBdJ-0007bw-3Z for pgsql-www@arkaria.postgresql.org; Tue, 17 Dec 2019 12:07:21 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1ihBdH-0003DM-ST for pgsql-www@arkaria.postgresql.org; Tue, 17 Dec 2019 12:07:19 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1ihBdH-0003DF-HK for pgsql-www@lists.postgresql.org; Tue, 17 Dec 2019 12:07:19 +0000 Received: from mail-lj1-x241.google.com ([2a00:1450:4864:20::241]) by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1ihBdE-0004ka-0x for pgsql-www@postgresql.org; Tue, 17 Dec 2019 12:07:17 +0000 Received: by mail-lj1-x241.google.com with SMTP id j6so10658317lja.2 for ; Tue, 17 Dec 2019 04:07:15 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=hagander-net.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=MAXV0ylevWqFrYKOShemEkMsimVhPYLCOny7O/IkLjQ=; b=LbPk9AuPB87QCu6azUeJaIwSuyu9s2nd5YjiKohycH5csC50fRHfqvmG67wVQ7J98B zNhXLiOLaEy1AyOD2+sUwXT+bvbvO9euzWB1cNuMyiAty+GCk/EZeKiHEr4ScNXrBYgY DC+mApHpBgboveq55aigXHUCezJ2QGlxV2wXsHyNy7dpfcNNnXpMqMqDw8wO0jNTfveo it1W38LUFtWa7p3w+EtN+WKNxZfc5pN4qoF9A1bF+n6mLXgHmYQYWNuMx3awJoekxfgO +asMlLFKxjz2QyT2EXoeyLDSmsJIMdTjqwm2nOGZKbApYGq38mNHsZPHQ3JjK5TWrqgJ eC8w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=MAXV0ylevWqFrYKOShemEkMsimVhPYLCOny7O/IkLjQ=; b=HqczFKdmlv9qG7WdO9h40xbT0BG2o02WlCeoCBuxWAq1a8nxMk1MjPn40vTmqFefut YYVMpUoCQECuCHjrTRmS9GSgfAGdf5TRIHV7JseILFRmpbOekmKth3p6DRIY9ClYFZp1 RxAP1EQg+AUBMcTL2kzGwO5pOmc6B8Ndxu5vlNBBLMxjV5k1Myezgkde2KFCe5aV3lPW M46fW6UZLpHzYvsAUv8jQbbGozOu8R2eu6k45HmbDguaeyOcSQl+5LMhIbkHHDMNgpRW Le7Nn9S9k5zZruKjOElwa9mJvWrYasJg6e+LXjb3SgmJfKU9ehArI4PqTXRNH7XR3kxi jx3g== X-Gm-Message-State: APjAAAWUp7Tnt2VCgkLtDay/hOkUwVw5g4sqp7PbFy7x55IUfHLiQsnP 3XWout1WmSPuUt7QAwatYUmCDw1BDA+fEUGNADS4nw== X-Google-Smtp-Source: APXvYqxlLdD7xYx8LvYet9TaAHNS8Vp2WR3x1Z/T+uALkl3oOYGGCW9yuCtCCamCC+mRL0ZsuRbo2FVY3ndZxdL50BA= X-Received: by 2002:a2e:88c4:: with SMTP id a4mr2871487ljk.174.1576584433913; Tue, 17 Dec 2019 04:07:13 -0800 (PST) MIME-Version: 1.0 References: In-Reply-To: From: Magnus Hagander Date: Tue, 17 Dec 2019 13:06:57 +0100 Message-ID: Subject: Re: client auth docs seem to have devolved To: Dave Cramer , Peter Eisentraut Cc: PostgreSQL-development , PostgreSQL WWW Content-Type: multipart/alternative; boundary="0000000000002464820599e52b86" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk --0000000000002464820599e52b86 Content-Type: text/plain; charset="UTF-8" On Tue, Dec 17, 2019 at 1:02 PM Dave Cramer wrote: > On Tue, 17 Dec 2019 at 06:53, Magnus Hagander wrote: > >> On Tue, Dec 17, 2019 at 12:43 PM Dave Cramer >> 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/ Work: https://www.redpill-linpro.com/ --0000000000002464820599e52b86 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Tue, Dec 17, 2019 at 1:02 PM Dave Cram= er <davecramer= @gmail.com> wrote:
On Tue, 17 Dec 2019 at 06:53, Magnus Hagander <magnus@hagander.net&g= t; wrote:
On Tue, = Dec 17, 2019 at 12:43 PM Dave Cramer <davecramer@gmail.com> wrote:
While following an old link to=C2=A0https://www.postgr= esql.org/docs/10/auth-methods.html

I see a list of l= inks to authentication methods. However:


There are absolutely no l= inks...


That's be= cause the structure of the docs changed. You need to hit "up", wh= ich will take you to=C2=A0https://www.postgresql.org/= docs/current/client-authentication.html, which now has the list of link= s. Note how the different methods used to be 20.3.x, and are now directly l= isted as 20.y.=C2=A0

I'm unsure if that was in= tentional in the upstream docs, but that's what makes the website behav= e like it does.=C2=A0

Fai= r enough but

20.3.=C2=A0Authentication Methods=

The following sections d= escribe the authentication methods in more detail.

certainly is misleading.


This was changed by Peter in commit=C2=A056811e57323= faa453947eb82f007e323a952e1a1 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.=C2=A0

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

--
=C2=A0Magnus Hagander
=C2=A0Me: https://www.hagander.net= /
=C2=A0Work: https://www.redpill-linpro.com/
--0000000000002464820599e52b86--