Re: [HACKERS] Interactive docs idea

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

In response to

Browse pgsql-hackers by date

  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

Browse pgsql-www by date

  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