Re: [pgsql-www] the sad state of our FAQs - Mailing list pgsql-docs

From Greg Smith
Subject Re: [pgsql-www] the sad state of our FAQs
Date
Msg-id alpine.GSO.2.01.0903270359020.22490@westnet.com
Whole thread Raw
In response to Re: [pgsql-www] the sad state of our FAQs  (Alvaro Herrera <alvherre@commandprompt.com>)
Responses Re: [pgsql-www] the sad state of our FAQs  (Alvaro Herrera <alvherre@commandprompt.com>)
List pgsql-docs
On Tue, 17 Mar 2009, Alvaro Herrera wrote:

> I'm also wondering why do we have two pages, FAQ and
> Frequently_Asked_Questions.  Shouldn't they be merged?

I started putting stuff on that other page while I waited for the official
FAQ to get migrated over.  There are a fair number of wiki pages tagged in
the FAQ category as well.  Some of those are too big to really merge
usefully into the FAQ, others might get dumped into the main document.

Several of the pages listed on there were aimed to replace or supplement
existing entries in the full FAQ from the start.  As an example, "4.2 How
do I control connections from other hosts?" has considerably less
information than any newbie needs to resolve those problems, as anybody
hanging out on IRC is painfully aware.  I wrote an initial draft of
something on the "Client Authentication" page on the Wiki to help pull
together pointers to all the relevant places in the documentation, into
something closer to a walkthrough, and the result is larger than FAQ-entry
length.  That's going to stay a FAQ *page* instead, I think, one that gets
pointed to as a supplemental reference for the terse description given for
4.2 right now.

I can help sort through all this once I get past my next conference gig in
another week, all my spare time has been spent tormenting systems with
pgbench lately.

--
* Greg Smith gsmith@gregsmith.com http://www.gregsmith.com Baltimore, MD

pgsql-docs by date:

Previous
From: Frank Wiles
Date:
Subject: Re: wal shipping/pg_standby docs patch
Next
From: Alvaro Herrera
Date:
Subject: Re: [pgsql-www] the sad state of our FAQs