public inbox for [email protected]  
help / color / mirror / Atom feed
From: Greg Smith <[email protected]>
To: Bruce Momjian <[email protected]>
Cc: Francisco Reyes <[email protected]>
Cc: Greg Sabino Mullane <[email protected]>
Cc: [email protected]
Subject: Re: Londiste
Date: Fri, 28 May 2010 15:34:55 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

Bruce Momjian wrote:
> That is an excellent idea, not only for replication, but there are
> probably other wiki pages that we should link to from our main docs.  I
> will go through the wiki, find appropriate pages, and add links from our
> docs.
>   

Please suggest what those pages are before you do the doc edits.  While 
we can fix stuff with redirection, in some cases it would be better to 
create a specific destination page for the documentation to point to, 
with a stable URL from the beginning.  For example, the last specific 
page we would want to point the docs toward is 
http://wiki.postgresql.org/wiki/Replication%2C_Clustering%2C_and_Connection_Pooling 
, which is ridiculous in length (I regret creating the page like that), 
going through a major revision right now (parallel descriptions being 
worked out at http://wiki.postgresql.org/wiki/Clustering ), and just 
generally a mess.

I'd rather see (and will create) specific pages created for Replication 
and Pooling if we want something the docs can be pointed towards.  As an 
example, I already created one such page but haven't filled in the 
details for the Nagios etc. doc updates Bruce already inserted:  
http://wiki.postgresql.org/wiki/Monitoring.

It's really obvious that PostgreSQL installs in the real world benefit 
from adding a number of non-core tools.  It's inappropriate and 
overwhelming to consider documenting them, or even listing them all, in 
the core docs.  It's also terrible that we don't make it easier for 
people to find those, and point out the seams where it's expected a 
third party package will fill in on something that's been punted out of 
core but is done well outside of it.  The wiki is a reasonable place to 
assemble both a highlights directory of such packages and associated 
documentation, all in one spot.

-- 
Greg Smith  2ndQuadrant US  Baltimore, MD
PostgreSQL Training, Services and Support
[email protected]   www.2ndQuadrant.us




view thread (20+ messages)  latest in thread

reply

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: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected]
  Subject: Re: Londiste
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox