Message-Id: <199910122049.VAA04297@linda.lfix.co.uk>
To: Bruce Momjian <maillist@candle.pha.pa.us>
cc: PostgreSQL-development <pgsql-hackers@postgreSQL.org>,
	PostgreSQL-documentation <docs@postgreSQL.org>
Subject: Re: [HACKERS] Outline for PostgreSQL book 
In-Reply-To: Message from Bruce Momjian <maillist@candle.pha.pa.us> of "Tue,
	12 Oct 1999 13:16:35 EDT." <199910121716.NAA29586@candle.pha.pa.us>
References: <199910121716.NAA29586@candle.pha.pa.us> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Tue, 12 Oct 1999 21:49:55 +0100
From: "Oliver Elphick" <olly@lfix.co.uk>

Bruce Momjian wrote:
  >Here is my proposal for an outline for a PostgreSQL book.  Many of us
  >have been asked by publishers about writing a book.  Here is what I
  >think would be a good outline for the book.
  >
  >I am interested in whether this is a good outline for a PostgreSQL book,
  >how our existing documentation matches this outline, where our existing
  >documentation can be managed into a published book, etc.
  >
  >Any comments would be welcome.
 

  >                          PostgreSQL Book Proposal
  >                                      
  >                               Bruce Momjian
  >   
  >   1.
  >          Introduction
  >   2.
  >          Installation
...
  >   3.
  >          Introduction to SQL
...

It looks good; I have a comment on the order of chapters, however.

I suggest that Installlation goes in an Appendix.  More and more, people
will be coming to machines that already have software installed, or have
them installed as packages (.rpm or .deb).

Installation is the administrator's job, and not of interest to `normal'
users, so it should not be placed in the book as if every user had to do
it.

-- 
      Vote against SPAM: http://www.politik-digital.de/spam/
                 ========================================
Oliver Elphick                                Oliver.Elphick@lfix.co.uk
Isle of Wight                              http://www.lfix.co.uk/oliver
               PGP key from public servers; key ID 32B8FAA1
                 ========================================
     "Blessed is the man who makes the LORD his trust, 
      who does not look to the proud, to those who turn 
      aside to false gods."            Psalms 40:4