| From: | Greg Stark <gsstark(at)mit(dot)edu> |
|---|---|
| To: | "Dave Page" <dpage(at)vale-housing(dot)co(dot)uk> |
| Cc: | "Greg Stark" <gsstark(at)mit(dot)edu>, <pgsql-hackers(at)postgresql(dot)org> |
| Subject: | Re: Interactive docs idea |
| Date: | 2005-04-14 17:39:11 |
| Message-ID: | 87oechgsw0.fsf@stark.xeocode.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers pgsql-www |
"Dave Page" <dpage(at)vale-housing(dot)co(dot)uk> writes:
> We can get from 2 - 10 a day I would guess. They get mailed to a closed
> list for moderation.
Uhm, then where are they?
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.
I think the idea of moderating the comments is inherently flawed. 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.
--
greg
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alvaro Herrera | 2005-04-14 18:09:38 | Re: Interactive docs idea |
| Previous Message | Simon Riggs | 2005-04-14 17:36:44 | Re: Constant time insertion into highly non-unique |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alvaro Herrera | 2005-04-14 18:09:38 | Re: Interactive docs idea |
| Previous Message | Alvaro Herrera | 2005-04-14 16:42:48 | Re: Interactive docs idea |