Re: [HACKERS] INSTALL/install.sgml file

From: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>, PostgreSQL-documentation <docs(at)postgresql(dot)org>
Subject: Re: [HACKERS] INSTALL/install.sgml file
Date: 2000-06-08 17:11:03
Message-ID: 200006081711.NAA13599@candle.pha.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

> 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(at)candle(dot)pha(dot)pa(dot)us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2000-06-10 02:14:10 Re: Update doc changes needed
Previous Message Peter Eisentraut 2000-06-08 17:02:49 Re: [HACKERS] INSTALL/install.sgml file

Browse pgsql-hackers by date

  From Date Subject
Next Message Ed Loehr 2000-06-08 17:25:09 Re: interactive oddity for psql -c "cmd; cmd;"
Previous Message Peter Eisentraut 2000-06-08 17:09:16 Re: interactive oddity for psql -c "cmd; cmd;"