Re: Platform-specific "FAQs" are waaaaaay outdated

Поиск
Список
Период
Сортировка
От Peter Eisentraut
Тема Re: Platform-specific "FAQs" are waaaaaay outdated
Дата
Msg-id Pine.LNX.4.21.0007172233240.2925-100000@localhost.localdomain
обсуждение исходный текст
Ответ на Re: Platform-specific "FAQs" are waaaaaay outdated  (Bruce Momjian <pgman@candle.pha.pa.us>)
Список pgsql-docs
Bruce Momjian writes:

> Yikes, that is very old.  Man, who is maintaining these.

The way I see it, at some point in the past some people have sorted out
and documented most or all of the problems for certain platforms in these
documents. Most of the problems were subsequently fixed, but no one
bothered to update the FAQs because

a) They didn't know about these documents.

b) The documents named a "maintainer", so others were afraid of interfering.

c) The "maintainer" was no longer around.


> I am not sure if we should just clean them up to remove the old stuff,
> or merge them into the docs.

It is my point of view that merging them into the docs is a much better
way to proceed, because it fixes a), b), and c). It also makes the docs
themselves better because there's no good reason for separating out some
documentation just because it's different on some platforms, causing users
to look elsewhere. This is especially inconvenient if you are reading the
HTML version in a browser or reading the hardcopy.

The existence of a separate FAQ indicates that the information in there is
not official to some extent. That doesn't shed a good light on things.

Unless someone objects firmly I am at least going to clean out the ones
that have not been updated since 1998, and I'll make a section in the
Administrator's Guide on managing shared memory and other resources based
on platform.


--
Peter Eisentraut                  Sernanders väg 10:115
peter_e@gmx.net                   75262 Uppsala
http://yi.org/peter-e/            Sweden


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

Предыдущее
От: Peter Eisentraut
Дата:
Сообщение: Pgadmin man page
Следующее
От: John McKown
Дата:
Сообщение: Printed Documentation