From: Bruce Momjian <bruce@momjian.us>
Message-Id: <200805071638.m47Gc9M25111@momjian.us>
Subject: Re: order of entries in admin docs
In-Reply-To: <dcc563d10803111010o4ff23972lfc0c62e69c4220db@mail.gmail.com>
To: Scott Marlowe <scott.marlowe@gmail.com>
Date: Wed, 7 May 2008 12:38:09 -0400 (EDT)
CC: pgsql-docs@postgresql.org
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="ELM1210178289-27620-2_"
Content-Transfer-Encoding: 7bit


--ELM1210178289-27620-2_
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"

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@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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

--ELM1210178289-27620-2_
Content-Transfer-Encoding: 7bit
Content-Type: text/x-diff
Content-Disposition: inline; filename="/rtmp/diff"

Index: doc/src/sgml/postgres.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v
retrieving revision 1.85
diff -c -c -r1.85 postgres.sgml
*** doc/src/sgml/postgres.sgml	14 Nov 2007 02:36:43 -0000	1.85
--- doc/src/sgml/postgres.sgml	7 May 2008 16:35:20 -0000
***************
*** 146,154 ****
    &installw;
    &runtime;
    &config;
    &user-manag;
    &manage-ag;
-   &client-auth;
    &charset;
    &maintenance;
    &backup;
--- 146,154 ----
    &installw;
    &runtime;
    &config;
+   &client-auth;
    &user-manag;
    &manage-ag;
    &charset;
    &maintenance;
    &backup;

--ELM1210178289-27620-2_--