authentication methods sections

Started by Peter Eisentrautabout 8 years ago4 messagesdocs
Jump to latest
#1Peter Eisentraut
peter_e@gmx.net

I find that the section authentication methods
<https://www.postgresql.org/docs/devel/static/auth-methods.html&gt; is
becoming harder to read and navigate, because we keep adding
authentication methods and more information about them, and it's all on
one HTML page. I propose to move those sections up one level in the
hierarchy so they end up on separate HTML pages.

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

Attachments:

0001-doc-Restructure-authentication-methods-sections.patchtext/plain; charset=UTF-8; name=0001-doc-Restructure-authentication-methods-sections.patch; x-mac-creator=0; x-mac-type=0Download+24-25
#2Magnus Hagander
magnus@hagander.net
In reply to: Peter Eisentraut (#1)
Re: authentication methods sections

On Thu, Apr 12, 2018 at 2:37 AM, Peter Eisentraut <
peter.eisentraut@2ndquadrant.com> wrote:

I find that the section authentication methods
<https://www.postgresql.org/docs/devel/static/auth-methods.html&gt; is
becoming harder to read and navigate, because we keep adding
authentication methods and more information about them, and it's all on
one HTML page. I propose to move those sections up one level in the
hierarchy so they end up on separate HTML pages.

+1, that definitely seems like a good idea.

--
Magnus Hagander
Me: https://www.hagander.net/ <http://www.hagander.net/&gt;
Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/&gt;

#3Peter Eisentraut
peter_e@gmx.net
In reply to: Magnus Hagander (#2)
Re: authentication methods sections

On 4/14/18 17:20, Magnus Hagander wrote:

On Thu, Apr 12, 2018 at 2:37 AM, Peter Eisentraut
<peter.eisentraut@2ndquadrant.com
<mailto:peter.eisentraut@2ndquadrant.com>> wrote:

I find that the section authentication methods
<https://www.postgresql.org/docs/devel/static/auth-methods.html
<https://www.postgresql.org/docs/devel/static/auth-methods.html&gt;&gt; is
becoming harder to read and navigate, because we keep adding
authentication methods and more information about them, and it's all on
one HTML page.  I propose to move those sections up one level in the
hierarchy so they end up on separate HTML pages.

+1, that definitely seems like a good idea. 

pushed

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

#4Michael Paquier
michael@paquier.xyz
In reply to: Peter Eisentraut (#3)
Re: authentication methods sections

On Sat, Apr 21, 2018 at 10:21:03AM -0400, Peter Eisentraut wrote:

On 4/14/18 17:20, Magnus Hagander wrote:

On Thu, Apr 12, 2018 at 2:37 AM, Peter Eisentraut
<peter.eisentraut@2ndquadrant.com
<mailto:peter.eisentraut@2ndquadrant.com>> wrote:

I find that the section authentication methods
<https://www.postgresql.org/docs/devel/static/auth-methods.html
<https://www.postgresql.org/docs/devel/static/auth-methods.html&gt;&gt; is
becoming harder to read and navigate, because we keep adding
authentication methods and more information about them, and it's all on
one HTML page.  I propose to move those sections up one level in the
hierarchy so they end up on separate HTML pages.

+1, that definitely seems like a good idea. 

pushed

Sorry for coming late here, but the patch which has been committed,
56811e57, results in a section which is completely empty:
https://www.postgresql.org/docs/devel/static/auth-methods.html

And all the authentication methods get listed here:
https://www.postgresql.org/docs/devel/static/client-authentication.html

So I find the result even more confusing than the original. Wouldn't it
be more simple to just remove "Authentication Methods" if the current
layer is kept?
--
Michael