Received: from localhost (unknown [200.46.208.211]) by mail.postgresql.org (Postfix) with ESMTP id 740A2632422 for ; Tue, 10 Mar 2009 05:05:31 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by localhost (mx1.hub.org [200.46.208.211]) (amavisd-maia, port 10024) with ESMTP id 59026-05 for ; Tue, 10 Mar 2009 05:05:23 -0300 (ADT) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail.gmx.net (mail.gmx.net [213.165.64.20]) by mail.postgresql.org (Postfix) with SMTP id AA2DE634BDC for ; Tue, 10 Mar 2009 05:05:00 -0300 (ADT) Received: (qmail invoked by alias); 10 Mar 2009 08:04:56 -0000 Received: from muc-ea-fw-1-imap.sun.com (EHLO dhcp-eham02-157-98.Germany.Sun.COM) [192.9.112.196] by mail.gmx.net (mp005) with SMTP; 10 Mar 2009 09:04:56 +0100 X-Authenticated: #495269 X-Provags-ID: V01U2FsdGVkX18xcpYPJ48xuiP38b/t5/JS8KdPgnzJ9v784cvmcT DnfNpqAbBExvOc Message-ID: <49B61F25.90607@gmx.net> Date: Tue, 10 Mar 2009 10:04:53 +0200 From: Peter Eisentraut User-Agent: Thunderbird 2.0.0.19 (Macintosh/20081209) MIME-Version: 1.0 To: jd@commandprompt.com CC: Alvaro Herrera , Stefan Kaltenbrunner , PostgreSQL www , pgsql-docs@postgresql.org Subject: Re: the sad state of our FAQs References: <49B27F0E.2050504@kaltenbrunner.cc> <20090307195305.GB3821@alvh.no-ip.org> <1236630078.4649.41.camel@jd-laptop.pragmaticzealot.org> In-Reply-To: <1236630078.4649.41.camel@jd-laptop.pragmaticzealot.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Y-GMX-Trusted: 0 X-FuHaFi: 0.67 X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=0.95 tagged_above=0 required=5 tests=AWL=0.950 X-Spam-Level: X-Archive-Number: 200903/60 X-Sequence-Number: 16714 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.)