From: Bruce Momjian <pgman@candle.pha.pa.us>
Message-Id: <200006081711.NAA13599@candle.pha.pa.us>
Subject: Re: [HACKERS] INSTALL/install.sgml file
In-Reply-To: <Pine.LNX.4.21.0006081807100.23619-100000@localhost.localdomain>
	"from Peter Eisentraut at Jun 8, 2000 07:02:49 pm"
To: Peter Eisentraut <peter_e@gmx.net>
Date: Thu, 8 Jun 2000 13:11:03 -0400 (EDT)
CC: Tom Lane <tgl@sss.pgh.pa.us>,
	PostgreSQL-development <pgsql-hackers@postgresql.org>,
	PostgreSQL-documentation <docs@postgresql.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII

> We can refer people, but how? Do you write "please read more about this in
> the Administrator's Guide"? Then somebody who's reading the installation
> instructions as part of the administrator's guide will think "Well, duh,
> thanks a lot". Or you make a proper DocBook hyperlink which comes out
> something like "read more about this in `Backing up and Restoring'". Then
> somebody who reads the flat text file will say "Gee, and where exactly is
> that?". Schizophrenia Bad.
> 
> IMHO, there's really a line between:
> * Installation Guide: how to get from sources to binaries (roughly)
> * Administration Guide: how to get from binaries to running system
> * Users (and other) Guide: how to make use of the running system

Good questions.  No good answers I can think of.

-- 
  Bruce Momjian                        |  http://www.op.net/~candle
  pgman@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