From: Bruce Momjian <maillist@candle.pha.pa.us>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: PostgreSQL-documentation <docs@postgreSQL.org>
Cc: PostgreSQL-development <pgsql-hackers@postgreSQL.org>
Subject: Re: [DOCS] Re: [HACKERS] Outline for PostgreSQL book
Date: Wed, 13 Oct 1999 08:51:12 -0400 (EDT)
Message-ID: <199910131251.IAA06628@candle.pha.pa.us> (raw)
In-Reply-To: <Pine.GSO.3.96.991013140113.18359F-100000@enequist.csd.uu.se>
> 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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: maillist@candle.pha.pa.us, peter_e@gmx.net, docs@postgreSQL.org, pgsql-hackers@postgreSQL.org
Subject: Re: [DOCS] Re: [HACKERS] Outline for PostgreSQL book
In-Reply-To: <199910131251.IAA06628@candle.pha.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox