public inbox for [email protected]  

help / color / mirror / Atom feed

From: Tom Lane <[email protected]>
To: Alvaro Herrera <[email protected]>
Cc: Stefan Kaltenbrunner <[email protected]>
Cc: PostgreSQL www <[email protected]>
Cc: [email protected]
Subject: Re: [DOCS] the sad state of our FAQs
Date: Sat, 07 Mar 2009 17:04:17 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

Alvaro Herrera <[email protected]> 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

view thread (29+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected]
  Subject: Re: [DOCS] the sad state of our FAQs
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox