public inbox for [email protected]
help / color / mirror / Atom feedFrom: Nikolay Samokhvalov <[email protected]>
To: [email protected]
To: PostgreSQL-documentation <[email protected]>
Subject: Users comments don't migrate to docs for new version?
Date: Wed, 6 Jun 2007 20:10:24 +0400
Message-ID: <[email protected]> (raw)
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
view thread (14+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected]
Subject: Re: Users comments don't migrate to docs for new version?
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox