Re: order of entries in admin docs - Mailing list pgsql-docs

From Tom Lane
Subject Re: order of entries in admin docs
Date
Msg-id 27873.1205257019@sss.pgh.pa.us
Whole thread Raw
In response to order of entries in admin docs  ("Scott Marlowe" <scott.marlowe@gmail.com>)
Responses Re: order of entries in admin docs  ("Scott Marlowe" <scott.marlowe@gmail.com>)
Re: order of entries in admin docs  (Bruce Momjian <bruce@momjian.us>)
List pgsql-docs
"Scott Marlowe" <scott.marlowe@gmail.com> writes:
> I was just looking for something in the admin docs, and it seems like
> the ordering of sections is sub-optimal.

> 17. Operating System Environment
> 18. Server Configuration
> 19. Database Roles and Privileges
> 20. Managing Databases
> 21. Client Authentication

> Seems that Client Authentication should come right after Server
> Configuration.  After all, how is someone going to handle roles and
> database creation before they've authenticated?

Well, until you know what a role is, the client auth discussion might
not make too much sense to you...

I'm not wedded to the current ordering but I'm not sure it's silly
either.

Something else that ought to be considered here is that now that we have
CONNECT privilege for databases, manipulating privileges is a lot saner
way to control who-can-connect-where than setting up fancy combinations
of user and database entries in pg_hba.conf.  AFAIR there is no mention
of this alternative in Chapter 21, but it seems like there ought to be.
With your proposed reorganization, that would become a forward
reference; is that OK?

            regards, tom lane

pgsql-docs by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: order of entries in admin docs
Next
From: "Scott Marlowe"
Date:
Subject: Re: order of entries in admin docs