Re: Interactive docs idea - Mailing list pgsql-hackers

From Joshua D. Drake
Subject Re: Interactive docs idea
Date
Msg-id 425EB227.9000304@commandprompt.com
Whole thread Raw
In response to Re: Interactive docs idea  (Greg Stark <gsstark@mit.edu>)
List pgsql-hackers
>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




pgsql-hackers by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: Interactive docs idea
Next
From: Greg Stark
Date:
Subject: Re: Interactive docs idea