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

Поиск
Список
Период
Сортировка
От Bruce Momjian
Тема Re: Interactive Documentation - how do you want it to work?
Дата
Msg-id 200302030056.h130uRq05077@candle.pha.pa.us
обсуждение исходный текст
Ответ на Interactive Documentation - how do you want it to work?  ("Dave Page" <dpage@vale-housing.co.uk>)
Список 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@candle.pha.pa.us               |  (610)
359-1001+  If your life is a hard drive,     |  13 Roberts Road +  Christ can be your backup.        |  Newtown Square,
Pennsylvania19073
 


В списке pgsql-hackers по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: Re: PGP signing releases
Следующее
От: Bruce Momjian
Дата:
Сообщение: Re: Interactive Documentation - how do you want it to