Received: from localhost (unknown [200.46.204.183]) by mail.postgresql.org (Postfix) with ESMTP id 13F5C632685; Sat, 7 Mar 2009 15:53:25 -0400 (AST) Received: from mail.postgresql.org ([200.46.204.86]) by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024) with ESMTP id 15973-10; Sat, 7 Mar 2009 15:53:23 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from lists.commandprompt.com (host-159.commandprompt.net [207.173.203.159]) by mail.postgresql.org (Postfix) with ESMTP id 085056324FE; Sat, 7 Mar 2009 15:53:22 -0400 (AST) Received: from perhan.alvh.no-ip.org (200-126-91-44.bk6-dsl.surnet.cl [200.126.91.44]) (authenticated bits=0) by lists.commandprompt.com (8.13.8/8.13.8) with ESMTP id n27Jxe2O015330 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat, 7 Mar 2009 11:59:45 -0800 Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000) id 7761847CDE; Sat, 7 Mar 2009 16:53:05 -0300 (CLST) Date: Sat, 7 Mar 2009 16:53:05 -0300 From: Alvaro Herrera To: Stefan Kaltenbrunner Cc: PostgreSQL www , pgsql-docs@postgresql.org Subject: Re: the sad state of our FAQs Message-ID: <20090307195305.GB3821@alvh.no-ip.org> References: <49B27F0E.2050504@kaltenbrunner.cc> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <49B27F0E.2050504@kaltenbrunner.cc> User-Agent: Mutt/1.5.18 (2008-05-17) X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.0 (lists.commandprompt.com [207.173.203.159]); Sat, 07 Mar 2009 11:59:46 -0800 (PST) X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=0 tagged_above=0 required=5 tests=none X-Spam-Level: X-Archive-Number: 200903/29 X-Sequence-Number: 16683 Stefan Kaltenbrunner wrote: > Our FAQs are in a really sad state and it#s about time to think about > what we want to do about that because in the current state there are > creating much more harm than good. [...] > My proposal is to move all the FAQs to the wiki(just with what happened > with the developer FAQ) with the hope that more people get interested in > keeping them up to date and only reference those on the main page that > at least contains "somewhat" accurate information.I honestly believe > that the current state is more damaging that not having any (translated > FAQs) at all. I completely agree that having a bad translation is worse than not having a translation at all. However, enthusiastic people will translate anything you throw at them, and if the tools don't help, the results will be less than ideal; bad formatting, slightly wrong answers, outdated answers. 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. -- Alvaro Herrera http://www.CommandPrompt.com/ PostgreSQL Replication, Consulting, Custom Development, 24x7 support