Re: [PATCHES] Replication Documentation - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: [PATCHES] Replication Documentation
Date
Msg-id 200608020302.k7232h229060@momjian.us
Whole thread Raw
In response to Re: [PATCHES] Replication Documentation  (Peter Eisentraut <peter_e@gmx.net>)
Responses Re: [PATCHES] Replication Documentation
List pgsql-hackers
I was thinking of something similar to our encryption section:
http://www.postgresql.org/docs/8.1/static/encryption-options.html

The idea being to define issues like multi/single master, async vs,
sync, and mention the projects which are in each category.

---------------------------------------------------------------------------

Peter Eisentraut wrote:
> Alvaro Herrera wrote:
> > > >I don't think this sort of material belongs directly into the
> > > > PostgreSQL documentation.
> >
> > Why not?
> 
> PostgreSQL documentation (or any product documentation) should be 
> factual: describe what the software does and give advice on its use.  
> This should be mostly independent of the external circumstances, 
> because people will still read that documentation three or four years 
> from now.
> 
> The proposed text is, at least partially, journalistic: it evaluates 
> competing ideas, gives historical and anecdotal information, reports on 
> current events, and makes speculations about the future.  That is the 
> sort of material that is published in periodicals or other volatile 
> media.
> 
> At the summit, we resolved, for precisely these reasons, to keep the 
> journalistic parts on the web site, for clear separation from the 
> shipped product and for easier updates (and for easier reference as 
> well, because the PostgreSQL documentation is not the single obvious 
> place to look for it) and refer to it from the documentation.
> 
> -- 
> Peter Eisentraut
> http://developer.postgresql.org/~petere/
> 
> ---------------------------(end of broadcast)---------------------------
> TIP 4: Have you searched our list archives?
> 
>                http://archives.postgresql.org

--  Bruce Momjian   bruce@momjian.us EnterpriseDB    http://www.enterprisedb.com
 + If your life is a hard drive, Christ can be your backup. +


pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Values list-of-targetlists patch for comments (was Re: [PATCHES] 8.2 features?)
Next
From: Bruce Momjian
Date:
Subject: Re: Values list-of-targetlists patch for comments (was Re: [PATCHES]