Re: [DOCS] the sad state of our FAQs

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
Cc: 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:04:17
Message-ID: 18162.1236463457@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-www

Alvaro Herrera <alvherre(at)commandprompt(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Brendan Jurd 2009-03-07 22:18:46 Re: [DOCS] the sad state of our FAQs
Previous Message Alvaro Herrera 2009-03-07 19:53:05 Re: the sad state of our FAQs

Browse pgsql-www by date

  From Date Subject
Next Message Brendan Jurd 2009-03-07 22:18:46 Re: [DOCS] the sad state of our FAQs
Previous Message Alvaro Herrera 2009-03-07 19:53:05 Re: the sad state of our FAQs