Date: Fri, 27 Mar 2009 04:13:33 -0400 (EDT)
From: Greg Smith <gsmith@gregsmith.com>
To: Alvaro Herrera <alvherre@commandprompt.com>
cc: Stefan Kaltenbrunner <stefan@kaltenbrunner.cc>,
	Tom Lane <tgl@sss.pgh.pa.us>, Brendan Jurd <direvus@gmail.com>,
	PostgreSQL www <pgsql-www@postgresql.org>, pgsql-docs@postgresql.org
Subject: Re: [DOCS] the sad state of our FAQs
In-Reply-To: <20090317193908.GJ4202@alvh.no-ip.org>
Message-ID: <alpine.GSO.2.01.0903270359020.22490@westnet.com>
References: <49B27F0E.2050504@kaltenbrunner.cc>
	<20090307195305.GB3821@alvh.no-ip.org>
	<18162.1236463457@sss.pgh.pa.us>
	<37ed240d0903071418u541851f8pac6cb16fe48e859d@mail.gmail.com>
	<18473.1236465193@sss.pgh.pa.us>
	<49B387A1.7090708@kaltenbrunner.cc>
	<20090317193908.GJ4202@alvh.no-ip.org>
User-Agent: Alpine 2.01 (GSO 1184 2008-12-16)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed

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