Re: [HACKERS] Outline for PostgreSQL book - Mailing list pgsql-docs

From Oliver Elphick
Subject Re: [HACKERS] Outline for PostgreSQL book
Date
Msg-id 199910122049.VAA04297@linda.lfix.co.uk
Whole thread Raw
In response to Outline for PostgreSQL book  (Bruce Momjian <maillist@candle.pha.pa.us>)
Responses Re: [HACKERS] Outline for PostgreSQL book  (Bruce Momjian <maillist@candle.pha.pa.us>)
List pgsql-docs
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



pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Outline for PostgreSQL book
Next
From: Bruce Momjian
Date:
Subject: Re: [HACKERS] Outline for PostgreSQL book