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

2003-02-02 Thread Bruce Momjian

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
  [EMAIL PROTECTED]   |  (610) 359-1001
  +  If your life is a hard drive, |  13 Roberts Road
  +  Christ can be your backup.|  Newtown Square, Pennsylvania 19073

---(end of broadcast)---
TIP 4: Don't 'kill -9' the postmaster



[HACKERS] Interactive Documentation - how do you want it to work?

2003-02-02 Thread Dave Page

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