From: Dave Cramer <Dave@micro-automation.net>
To: Richard <poboxcanada@yahoo.com>
To: pgsql-general@postgresql.org
Subject: Re: Annotatable on-line documentation
Date: Fri, 16 Feb 2001 15:28:53 -0500
Message-ID: <00f701c09857$140c48e0$1f870740@thebigone> (raw)
References: <20010216174055.24388.qmail@web6401.mail.yahoo.com>
You should have a look at the wiki stuff
http://c2.com/cgi/wiki?WikiWikiWeb
Dave
----- Original Message -----
From: "Richard" <poboxcanada@yahoo.com>
To: <pgsql-general@postgresql.org>
Sent: Friday, February 16, 2001 12:40 PM
Subject: [GENERAL] Annotatable on-line documentation
> (This was: "Re: [GENERAL] Re: PostgreSQL vs Oracle vs
> DB2 vs MySQL - Which should I use?", but I think a new
> thread has spun off...)
>
> [Tom Lane said ...]
> > I agree we need to work harder on making answers
> findable
> > outside the mailing lists. Improving the docs,
> making the mail archives
> > more easily searchable, etc etc. I dunno if an
> "annotated manual" would
> > help --- I've never used one --- but if people want
> to try one, it can't hurt.
>
> [... to which Bruce Momjian added ...]
> > I will say that the FAQ and my book have visibly
> reduced the number of
> > questions. When I put something on the FAQ, the
> questions about that
> > topic just magically go away.
>
> I have not used an annotated document either.
> However, I could see such a beast being used in the
> development of the documentation in a way that is not
> dissimilar to the development of the product itself.
> That is, I see an annotatable set of documentation as
> similar in nature to the developmental version of the
> product. After some period of development, some lucky
> editor(s) would fold the annotations into the document
> proper, periodically releasing the "stable" version of
> the docs.
>
> Would this lighten the work load on the folk that are
> currently maintaining the docs? Would it lighten the
> work load for the core developers? Would it stimulate
> the development of richer documetation? Would it draw
> some of the load off the mailing lists?
>
> A pilot project may be enlightening. Anyone have
> experience with setting up/maintaining annotatable
> on-line documentation?
>
> Cheers,
> Richard Blackwell
> Programmer/Analyst
> Simon Fraser University
> Burnaby, BC Canada
>
>
>
> __________________________________________________
> Do You Yahoo!?
> Get personalized email addresses from Yahoo! Mail - only $35
> a year! http://personal.mail.yahoo.com/
>
>
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: Dave@micro-automation.net, poboxcanada@yahoo.com, pgsql-general@postgresql.org
Subject: Re: Annotatable on-line documentation
In-Reply-To: <00f701c09857$140c48e0$1f870740@thebigone>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox