Skip site navigation (1) Skip section navigation (2)

Re: order of entries in admin docs

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: "Scott Marlowe" <scott(dot)marlowe(at)gmail(dot)com>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: order of entries in admin docs
Date: 2008-03-11 17:36:59
Message-ID: 27873.1205257019@sss.pgh.pa.us (view raw or flat)
Thread:
Lists: pgsql-docs
"Scott Marlowe" <scott(dot)marlowe(at)gmail(dot)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

In response to

Responses

pgsql-docs by date

Next:From: Scott MarloweDate: 2008-03-11 18:18:44
Subject: Re: order of entries in admin docs
Previous:From: Alvaro HerreraDate: 2008-03-11 17:21:47
Subject: Re: order of entries in admin docs

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group