Received: from localhost (maia-3.hub.org [200.46.204.184]) by postgresql.org (Postfix) with ESMTP id A8B8D9FB554; Wed, 6 Jun 2007 13:40:42 -0300 (ADT) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.184]) (amavisd-maia, port 10024) with ESMTP id 05020-02; Wed, 6 Jun 2007 13:40:28 -0300 (ADT) X-Greylist: from auto-whitelisted by SQLgrey-1.7.5 X-Greylist: from auto-whitelisted by SQLgrey-1.7.5 Received: from lists.commandprompt.com (host-254.commandprompt.net [207.173.203.254]) by postgresql.org (Postfix) with ESMTP id 13E7C9FB524; Wed, 6 Jun 2007 13:40:37 -0300 (ADT) Received: from perhan.alvh.no-ip.org (201-221-217-243.bk12-dsl.surnet.cl [201.221.217.243]) (authenticated bits=0) by lists.commandprompt.com (8.13.7/8.13.6) with ESMTP id l56GeXi1009672; Wed, 6 Jun 2007 09:40:33 -0700 Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000) id ED72532A28; Wed, 6 Jun 2007 12:40:29 -0400 (CLT) Date: Wed, 6 Jun 2007 12:40:29 -0400 From: Alvaro Herrera To: nikolay@samokhvalov.com Cc: pgsql-www@postgresql.org, PostgreSQL-documentation Subject: Re: Users comments don't migrate to docs for new version? Message-ID: <20070606164029.GB11800@alvh.no-ip.org> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.13 (2006-08-11) X-Virus-Scanned: ClamAV version 0.88.5, clamav-milter version 0.88.5 on projects.commandprompt.com X-Virus-Status: Clean X-Greylist: Sender succeded SMTP AUTH authentication, not delayed by milter-greylist-1.6 (lists.commandprompt.com [192.168.2.159]); Wed, 06 Jun 2007 09:40:39 -0700 (PDT) X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200706/6 X-Sequence-Number: 12045 Nikolay Samokhvalov wrote: > I've just found (via google...) useful (for me) comments: > http://www.postgresql.org/docs/8.0/interactive/sql-createaggregate.html > -- I mean users comments under primary contents of the page. > > These comments were written for 8.0, but are useful for the current > versions too. What we have is the situation that reading docs for 8.2 > people don't see these comments -- so this potentially useful > information is lost. So, in this implementation the idea of comments > for docs becomes weak in general. The thing to do in these cases is to move the useful info from the user comments into the main doc text. -- Alvaro Herrera http://www.advogato.org/person/alvherre "La victoria es para quien se atreve a estar solo"