Received: from localhost (maia-4.hub.org [200.46.204.183]) by postgresql.org (Postfix) with ESMTP id 107929FB30E for ; Thu, 7 Jun 2007 03:10:25 -0300 (ADT) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024) with ESMTP id 78526-02 for ; Thu, 7 Jun 2007 03:10:20 -0300 (ADT) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.4 Received: from an-out-0708.google.com (an-out-0708.google.com [209.85.132.247]) by postgresql.org (Postfix) with ESMTP id 3458D9FB303 for ; Thu, 7 Jun 2007 03:10:20 -0300 (ADT) Received: by an-out-0708.google.com with SMTP id c36so197720ana for ; Wed, 06 Jun 2007 23:10:19 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:sender:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth; b=G1/sB3W21qMXvuo7ziZYj5eeAjJIeXeH5U04a9qlWj7wmerNPhwUIEKG5Ns4eoGpxXVtz9FKjmIzIYPjKC9npkzSo9Vx0sluT3A0ZPf5Nm/8gnbQ1/6+/0dyqBvKDCJRecLQ1VH3f1872GQlzfVwz2Zu4CXS2WpdV6NiTMpWe9s= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:sender:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth; b=r+r1n95q0+kBd9wR/U1JAGbP8gIOmTsF6XhXI+8grSjWDZh00x47eCtmsjIyEklad4rCJVluWwaUIDS/8PKH5MhHaNYBBBggkOqPi6zEg5yoqi2xutrUfHIqo9/dwumUp/+hF3S0G/VoVUHlTavzFhpClF0DGTWNWObp2OhGLxQ= Received: by 10.100.139.12 with SMTP id m12mr826994and.1181196619445; Wed, 06 Jun 2007 23:10:19 -0700 (PDT) Received: by 10.100.12.14 with HTTP; Wed, 6 Jun 2007 23:10:19 -0700 (PDT) Message-ID: Date: Thu, 7 Jun 2007 10:10:19 +0400 From: "Nikolay Samokhvalov" To: "Magnus Hagander" Subject: Re: [DOCS] Users comments don't migrate to docs for new version? Cc: "Alvaro Herrera" , pgsql-www@postgresql.org, PostgreSQL-documentation In-Reply-To: <46670885.1050207@hagander.net> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <20070606164029.GB11800@alvh.no-ip.org> <46670885.1050207@hagander.net> X-Google-Sender-Auth: 5ac6cdda9a5385e2 X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200706/12 X-Sequence-Number: 12051 On 6/6/07, Magnus Hagander wrote: > Alvaro Herrera wrote: > > The thing to do in these cases is to move the useful info from the user > > comments into the main doc text. > > Yeah, that's the idea. Tom often goes through the comments and puts > stuff into the docs. But I'm sure there are a *lot* of other people who > could help with that as well - read comments, figure out of they make > sense, and submit a docs patch for the next version! > > //Magnus But I suppose there are some cases when it's not possible to move the comment to the main text -- e.g. if the comment concerns too narrow area, is very specific and is useful not for all people (but still useful for some!). Moreover, moving good comments to the main text makes the text bloated -- what if we have 10 examples of using function aaa() and all of them are illustrations for different areas? We (ok, sorry, Tom because only he knows English) will choose only 1 of them to avoid bloating of the main text, even if all 10 use cases has some specific features... Users comment collection is a good thing! Ask any PHP developer -- many of them will say that user comments that the main manual has are something like cookbooks -- lots of useful recipes. I could help with (yeah, not with reworking comments -- I do not know English well :-) ) creating a simple patch that adds a notice "this comment was originally created for version 8.0" and maybe something else in this direction -- these my thoughts are not fresh, I always lacked good user comments... BTW, then we would add some marking/rating system to the comments to allow other users see what comment is really useful. -- Best regards, Nikolay