Re: Londiste - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Londiste
Date
Msg-id 201005282035.o4SKZca20252@momjian.us
Whole thread Raw
In response to Re: Londiste  (Greg Smith <greg@2ndquadrant.com>)
List pgsql-docs
Greg Smith wrote:
> 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.

OK, let me troll around and find too pages.  Is there a good way to
review all the useful ones?

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

pgsql-docs by date:

Previous
From: Greg Smith
Date:
Subject: Re: Londiste
Next
From: Bruce Momjian
Date:
Subject: Re: documentation build log is busted, and has been for awhile