public inbox for [email protected]  

help / color / mirror / Atom feed

From: Peter Eisentraut <[email protected]>
To: [email protected]
Cc: Alvaro Herrera <[email protected]>
Cc: Stefan Kaltenbrunner <[email protected]>
Cc: PostgreSQL www <[email protected]>
Cc: [email protected]
Subject: Re: the sad state of our FAQs
Date: Tue, 10 Mar 2009 10:04:53 +0200
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<[email protected]>

Joshua D. Drake wrote:
> On Sat, 2009-03-07 at 16:53 -0300, Alvaro Herrera wrote:
> 
>> 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.
> 
> I would like to see us have a single documentation standard though. Our
> core docs are still Docbook SGML which is a bit different :( Other than
> that, I am all for it.

I think, although others might disagree, that the FAQ is by its nature 
more of a web resource than a software documentation resource.  So it 
ought to be managed by the standards of the web site, e.g., rapid 
releases, version independent, whatever translation system the web site 
uses.  (I consider the wiki to be an extension of the web site, for this 
argument.)

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], [email protected]
  Subject: Re: 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