Re: [PATCHES] Contrib docs v1

Поиск
Список
Период
Сортировка
От Bruce Momjian
Тема Re: [PATCHES] Contrib docs v1
Дата
Msg-id 200711120306.lAC36AD27466@momjian.us
обсуждение исходный текст
Ответ на Re: [PATCHES] Contrib docs v1  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-docs
Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Tom Lane wrote:
> >> What is the point of such a distinction?
>
> > If the contrib value is the source code itself then it seems a README is
> > more appropriate as people are not going to install the contrib module
> > itself --- they are using it only to learn.
>
> I find this argument pretty unconvincing.  Most of the contrib modules
> serve at least some purpose as coding examples.
>
> If we set up a situation where all but one or two are documented in the
> main SGML docs, the net effect will be that people don't even know that
> the ones left out exist.  Even a module that's only useful as an example
> won't be useful at all, if people don't find it.

Makes sense.  Albert, can you do the remaining READMEs?  You can skip
tsearch2 and the Japanese ones.  That is going away before final 8.3.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://postgres.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

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

Предыдущее
От: Tom Lane
Дата:
Сообщение: Re: [PATCHES] Contrib docs v1
Следующее
От: Markus Schiltknecht
Дата:
Сообщение: Re: High Availability, Load Balancing, and Replication Feature Matrix