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

From Tom Lane
Subject Re: [DOCS] the sad state of our FAQs
Date
Msg-id 18162.1236463457@sss.pgh.pa.us
Whole thread Raw
In response to Re: the sad state of our FAQs  (Alvaro Herrera <alvherre@commandprompt.com>)
Responses Re: [DOCS] the sad state of our FAQs  (Brendan Jurd <direvus@gmail.com>)
List pgsql-www
Alvaro Herrera <alvherre@commandprompt.com> writes:
> 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.

ISTM there are two separate issues here.  One is whether we want to get
the FAQs out of CVS and into some more widely-editable place.  The other
is whether to adopt some tools/framework to ease maintenance of
translated versions.  I'm in favor of both (though am not personally
prepared to expend any work for it :-().  I do not know whether xml2po
is the most suitable tool, though.

The one good thing that having the FAQs in CVS does for us is make it
fairly easy to have version-specific FAQs.  I don't think we've really
exploited that capability, except in the indirect sense that we simply
stopped updating back branches' FAQs (which hardly seems ideal).  So
losing it doesn't seem like a showstopper objection to me.  Still, it's
something that might be nice to preserve if we can.

            regards, tom lane

pgsql-www by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: the sad state of our FAQs
Next
From: Brendan Jurd
Date:
Subject: Re: [DOCS] the sad state of our FAQs