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
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 |
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 |