Users comments don't migrate to docs for new version?

From: "Nikolay Samokhvalov" <samokhvalov(at)gmail(dot)com>
To: pgsql-www(at)postgresql(dot)org, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Users comments don't migrate to docs for new version?
Date: 2007-06-06 16:10:24
Message-ID: e431ff4c0706060910l4c79bf65ycc87cc617cd063f9@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-www

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

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Christian Rossow 2007-06-06 16:33:36 Probably mistake in Arrays docs & proposal for index
Previous Message Bruce Momjian 2007-05-30 19:45:37 Re: [PERFORM] [doc patch] a slight VACUUM / VACUUM FULL doc improvement proposal

Browse pgsql-www by date

  From Date Subject
Next Message Alvaro Herrera 2007-06-06 16:40:29 Re: Users comments don't migrate to docs for new version?
Previous Message Mohsen Pahlevanzadeh 2007-06-06 00:12:08 Re: Persian User Group