Received: from localhost (maia-5.hub.org [200.46.204.182]) by postgresql.org (Postfix) with ESMTP id CE8A99FB4C4 for ; Wed, 6 Jun 2007 13:10:30 -0300 (ADT) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.182]) (amavisd-maia, port 10024) with ESMTP id 94806-01 for ; Wed, 6 Jun 2007 13:10:19 -0300 (ADT) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.5 Received: from an-out-0708.google.com (an-out-0708.google.com [209.85.132.251]) by postgresql.org (Postfix) with ESMTP id 48BC29FB724 for ; Wed, 6 Jun 2007 13:10:25 -0300 (ADT) Received: by an-out-0708.google.com with SMTP id c36so79972ana for ; Wed, 06 Jun 2007 09:10:24 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:reply-to:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition; b=KAt8ZGU9bLsyBsLnA00Q8TL661zivAtKwZ5PdFvUrrTAtnPEUsSmzVTn3ZGLHSLQekW0VlTrTQY9J+q5qgudsXQa+LfpAjpv8ZanWoUxPJupOoIcxfx+0O0/D4q6CWZ0B//KDt8Gz/by7Z9SXVGT6fGhYxwRdXZRbx/xuLvwg4c= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:reply-to:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition; b=Ihcu9//z1jGGBSXtIHaV8Q/ByKgWQZw1zneyt9GRWTxo9U+cheJxPb62tf9uqK6MlCWlmskXgkt0rWRjM7qDaNpsjoMS8ITeeYoHGTF0PpIpwYPYvTzmEgofkG+Hu0MnjpUzga+9k0H7A1QAqaJ/SQzJjB9bNG+J5eIzowIs5DI= Received: by 10.100.191.5 with SMTP id o5mr386552anf.1181146224423; Wed, 06 Jun 2007 09:10:24 -0700 (PDT) Received: by 10.100.12.14 with HTTP; Wed, 6 Jun 2007 09:10:24 -0700 (PDT) Message-ID: Date: Wed, 6 Jun 2007 20:10:24 +0400 From: "Nikolay Samokhvalov" Reply-To: nikolay@samokhvalov.com To: pgsql-www@postgresql.org, PostgreSQL-documentation Subject: Users comments don't migrate to docs for new version? MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200706/5 X-Sequence-Number: 12044 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. In some other OSS projects comments for docs are used intensively and hold a lot of useful information for many people. The good example here is PHP docs -- sometimes comments are much more useful and much more important then the main contents itself! I understand that comments migration and maintenance might be a hard task, because some comments may be really out-dated... Maybe simple notice like "this comment was created for pg 8.0 docs" would help. -- Best regards, Nikolay