Skip site navigation (1) Skip section navigation (2)

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 (view raw or flat)
Thread:
Lists: pgsql-docspgsql-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

pgsql-docs by date

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

pgsql-hackers by date

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

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group