From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | Greg Smith <greg(at)2ndquadrant(dot)com> |
Cc: | Francisco Reyes <lists(at)stringsutils(dot)com>, Greg Sabino Mullane <greg(at)turnstep(dot)com>, pgsql-docs(at)postgresql(dot)org |
Subject: | Re: Londiste |
Date: | 2010-05-28 20:35:38 |
Message-ID: | 201005282035.o4SKZca20252@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | 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(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2010-05-28 22:42:20 | Re: documentation build log is busted, and has been for awhile |
Previous Message | Greg Smith | 2010-05-28 19:34:55 | Re: Londiste |