Re: [DOCS] Re: [HACKERS] Outline for PostgreSQL book
Bruce Momjian <maillist@candle.pha.pa.us>
From: Bruce Momjian <maillist@candle.pha.pa.us>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: PostgreSQL-documentation <docs@postgreSQL.org>, PostgreSQL-development <pgsql-hackers@postgreSQL.org>
Date: 1999-10-13T12:51:12Z
Lists: pgsql-hackers
> 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