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

From Bruce Momjian
Subject Re: [DOCS] Re: [HACKERS] Outline for PostgreSQL book
Date
Msg-id 199910131251.IAA06628@candle.pha.pa.us
Whole thread Raw
In response to Re: [DOCS] Re: [HACKERS] Outline for PostgreSQL book  (Peter Eisentraut <e99re41@csd.uu.se>)
List pgsql-docs
> On Wed, 13 Oct 1999, Bruce Momjian wrote:
>
> > Not sure how to merge current documentation into it.  I would like to
> > point them to URL locations as much as possible.  I thought if I give
> > them enough to get started, and to understand how the current docs fit
> > together, that would be good.
>
> Personally, I always think that computer books that point you to URLs to
> get the complete information are less than desirable. The very point of
> reading the book is that you don't have to get up to your computer all the
> time. Books should be self-contained and add to the existing documentation
> since otherwise I won't need it.
>
> Also, think about the fact that the online documentation might change more
> quickly than a book is published. In a magazine you can do that, but in a
> book that's questionable. I have a few books that are only about two years
> old and the information in them is still very valid, but the URLs with all
> the examples and all don't work anymore. Who knows why, I don't have the
> time to find out.
>

I just don't want to produce a 500 page book to cover these topics.

--
  Bruce Momjian                        |  http://www.op.net/~candle
  maillist@candle.pha.pa.us            |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026

pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: [DOCS] Re: [HACKERS] Outline for PostgreSQL book
Next
From: Peter Mount
Date:
Subject: RE: [DOCS] Re: [HACKERS] Outline for PostgreSQL book