The comments in the PHP docs, while they contain a lot of garbage also containIf it were I, we would start a wiki that was linked from the docs but not have the docs
a lot of helpful tips and warnings. There's hardly any in the Postgres docs.
themselves have the comments.
If more people were intelligent and reasonable human beings you would be correct.
I think the idea of moderating the comments is inherently flawed.
I have seen the comments we get and a lot are complete garbage.
You can
either have the deliberate, planned documentation without the comments, or you
can have the wild-west style comments system, but trying to have it both ways
is impossible. It just leads to the current situation where the comments are
moribund.
See my comment about a wiki :)
Also shouldn't this all be on pgsql-www?
Sincerely,
Joshua D. Drake
---------------------------(end of broadcast)--------------------------- TIP 5: Have you checked our extensive FAQ?
http://www.postgresql.org/docs/faq