Re: order of entries in admin docs

From: Bruce Momjian <bruce(at)momjian(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-05-07 16:38:09
Message-ID: 200805071638.m47Gc9M25111@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Scott Marlowe wrote:
> 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? Is there some reason
> for the order that I'm missing? Is it an easy change? I'd be happy
> to try and make a patch for something like that if there's a chance of
> it getting through / my figuring out how to do it in the docs.

Agreed, section moved by attached patch. The new ordering makes more
sense because you can't do much database management until you have
client authentication setup properly.

I bet this will reduce the number of people who don't realize they need
to modify pg_hba.conf.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

Attachment Content-Type Size
/rtmp/diff text/x-diff 659 bytes

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2008-05-07 16:39:15 Re: order of entries in admin docs
Previous Message Bruce Momjian 2008-05-07 16:34:06 Re: order of entries in admin docs