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

From Bruce Momjian
Subject Re: order of entries in admin docs
Date
Msg-id 200805071638.m47Gc9M25111@momjian.us
Whole thread Raw
In response to order of entries in admin docs  ("Scott Marlowe" <scott.marlowe@gmail.com>)
List 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@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +
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;

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: order of entries in admin docs
Next
From: Bruce Momjian
Date:
Subject: Re: order of entries in admin docs