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

From Alvaro Herrera
Subject Re: the sad state of our FAQs
Date
Msg-id 20090307195305.GB3821@alvh.no-ip.org
Whole thread Raw
In response to the sad state of our FAQs  (Stefan Kaltenbrunner <stefan@kaltenbrunner.cc>)
Responses Re: [DOCS] the sad state of our FAQs  (Tom Lane <tgl@sss.pgh.pa.us>)
Re: the sad state of our FAQs  (Bruce Momjian <bruce@momjian.us>)
Re: the sad state of our FAQs  ("Joshua D. Drake" <jd@commandprompt.com>)
List pgsql-www
Stefan Kaltenbrunner wrote:
> Our FAQs are in a really sad state and it#s about time to think about
> what we want to do about that because in the current state there are
> creating much more harm than good.

[...]

> My proposal is to move all the FAQs to the wiki(just with what happened
> with the developer FAQ) with the hope that more people get interested in
>  keeping them up to date and only reference those on the main page that
> at least contains "somewhat" accurate information.I honestly believe
> that the current state is more damaging that not having any (translated
> FAQs) at all.

I completely agree that having a bad translation is worse than not
having a translation at all.  However, enthusiastic people will
translate anything you throw at them, and if the tools don't help, the
results will be less than ideal; bad formatting, slightly wrong answers,
outdated answers.

If we move the FAQ to the wiki, the outdated translations will not
disappear nor be automatically updated.  I claim that if we move them to
a translatable framework that helps people notice when the translation
is nonexistant or out of date, we will have better results.

I proposed this previously but got no support from Bruce who is supposed
to be the FAQ maintainer, and thus I ended up doing nothing.  Therefore
I now offer to do the job required to move them to XML Docbook and allow
translatability using xml2po or something similar.

--
Alvaro Herrera                                http://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

pgsql-www by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: the sad state of our FAQs
Next
From: Tom Lane
Date:
Subject: Re: [DOCS] the sad state of our FAQs