Skip site navigation (1) Skip section navigation (2)

Re: [DOCS] the sad state of our FAQs

From: Selena Deckelmann <selenamarie(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Brendan Jurd <direvus(at)gmail(dot)com>, Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Stefan Kaltenbrunner <stefan(at)kaltenbrunner(dot)cc>, PostgreSQL www <pgsql-www(at)postgresql(dot)org>, pgsql-docs(at)postgresql(dot)org
Subject: Re: [DOCS] the sad state of our FAQs
Date: 2009-03-07 22:52:19
Message-ID: 0C6B09FB-86B0-42F4-BAA9-4E9797B66150@gmail.com (view raw or flat)
Thread:
Lists: pgsql-docspgsql-www
On Mar 7, 2009, at 2:33 PM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:

> Brendan Jurd <direvus(at)gmail(dot)com> writes:
>> Although to be frank I think the value of per-version FAQs is  
>> dubious.
>> I would be totally okay with seeing the back-branch FAQs abandoned in
>> favour of the One FAQ (to rule them all, etc).
>
> I think it might well be true though that it'd be better to have one  
> FAQ
> with answers that say something like "Before version x.y, do this ...
> in x.y and later, do that ...".  That approach makes sure that people
> know that they are reading version-specific advice; whereas the  
> separate
> FAQs approach makes it pretty easy for people to fail to notice that
> they are reading advice that's inappropriate for their version.

Another approach would be to tag each FAQ with what version it was  
created for and what version it is deprecated for. (pretty much what  
Brenden suggested, but slightly less overhead than listing all  
versions the FAQ applies to)

Then we could do cool things like generate the version specific FAQs  
programmatically and not ever worry about removing them.

-Selena

In response to

Responses

pgsql-docs by date

Next:From: Guillaume LelargeDate: 2009-03-07 22:59:55
Subject: Re: the sad state of our FAQs
Previous:From: Tom LaneDate: 2009-03-07 22:33:13
Subject: Re: [DOCS] the sad state of our FAQs

pgsql-www by date

Next:From: Guillaume LelargeDate: 2009-03-07 22:59:55
Subject: Re: the sad state of our FAQs
Previous:From: Tom LaneDate: 2009-03-07 22:33:13
Subject: Re: [DOCS] the sad state of our FAQs

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group