From: | "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com> |
---|---|
To: | Greg Stark <gsstark(at)mit(dot)edu> |
Cc: | Dave Page <dpage(at)vale-housing(dot)co(dot)uk>, pgsql-hackers(at)postgresql(dot)org, pgsql-www(at)postgresql(dot)org |
Subject: | Re: [HACKERS] Interactive docs idea |
Date: | 2005-04-14 18:10:47 |
Message-ID: | 425EB227.9000304@commandprompt.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers pgsql-www |
>The comments in the PHP docs, while they contain a lot of garbage also contain
>a lot of helpful tips and warnings. There's hardly any in the Postgres docs.
>
>
If it were I, we would start a wiki that was linked from the docs but
not have the docs
themselves have the comments.
>
>I think the idea of moderating the comments is inherently flawed.
>
If more people were intelligent and reasonable human beings you would be
correct.
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
From | Date | Subject | |
---|---|---|---|
Next Message | Greg Stark | 2005-04-14 19:01:10 | Re: Interactive docs idea |
Previous Message | Alvaro Herrera | 2005-04-14 18:09:38 | Re: Interactive docs idea |
From | Date | Subject | |
---|---|---|---|
Next Message | Sergey E. Koposov | 2005-04-14 18:45:36 | Typo in http://archives.postgresql.org/ |
Previous Message | Alvaro Herrera | 2005-04-14 18:09:38 | Re: Interactive docs idea |