From: Bruce Momjian <pgman@candle.pha.pa.us>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>
Cc: PostgreSQL-documentation <docs@postgresql.org>
Subject: Re: [HACKERS] INSTALL/install.sgml file
Date: Thu, 8 Jun 2000 13:11:03 -0400 (EDT)
Message-ID: <200006081711.NAA13599@candle.pha.pa.us> (raw)
In-Reply-To: <Pine.LNX.4.21.0006081807100.23619-100000@localhost.localdomain>
> 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
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: pgman@candle.pha.pa.us, peter_e@gmx.net, tgl@sss.pgh.pa.us, pgsql-hackers@postgresql.org, docs@postgresql.org
Subject: Re: [HACKERS] INSTALL/install.sgml file
In-Reply-To: <200006081711.NAA13599@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