Re: Interactive Documentation - how do you want it to work?

From: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
To: Dave Page <dpage(at)vale-housing(dot)co(dot)uk>
Cc: PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Interactive Documentation - how do you want it to work?
Date: 2003-02-03 00:56:26
Message-ID: 200302030056.h130uRq05077@candle.pha.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers


Yes, please delete the old comments. We want to merge as many in as we
can, and remove the rest.

---------------------------------------------------------------------------

Dave Page wrote:
>
> As you may have noticed we have recently revamped the Interactive
> Documentation on the website (http://www.postgresql.org/docs). This has
> raised a couple of questions about how the idocs should work, so I'd
> like to get some votes on the following 2 issues:
>
> 1) How should comments be linked to document sets?:
>
> - Each comment attaches only to the page name & version of the page to
> which it was submitted.
>
> - Each comment attaches only to the page name, version of the page to
> which it was submitted *and* subsequent versions (this is the current
> behaviour).
>
> - Each comment should attach to the page name to which it was submitted
> regardless of the version.
>
> 2) Bearing in mind your answer to the previous question, should all the
> comments be deleted when useful examples have been merged into the main
> documents (remember that the definition of 'useful' may vary), or should
> we only remove the 'junk' ones?
>
> - Yes
>
> - No
>
> Thanks, Dave.
>
> ---------------------------(end of broadcast)---------------------------
> TIP 4: Don't 'kill -9' the postmaster
>

--
Bruce Momjian | http://candle.pha.pa.us
pgman(at)candle(dot)pha(dot)pa(dot)us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 2003-02-03 01:00:54 Re: Interactive Documentation - how do you want it to
Previous Message Tom Lane 2003-02-03 00:55:32 Re: PGP signing releases