Re: improve routine vacuuming docs

Поиск
Список
Период
Сортировка
От Peter Eisentraut
Тема Re: improve routine vacuuming docs
Дата
Msg-id 200312120041.13343.peter_e@gmx.net
обсуждение исходный текст
Ответ на improve routine vacuuming docs  (Neil Conway <neilc@samurai.com>)
Ответы Re: improve routine vacuuming docs
Список pgsql-patches
Neil Conway wrote:
> This patch makes some improvements and adds some details to the
> documentation on routine database maintenance activities. Any
> comments on the new text would be appreciated.

It's kind of hard to see what you have really changed.  Can you provide
a summary?

> I also corrected a bunch of instances of SGML usage. One of these
> days I'll get around to writing a style guide for the PostgreSQL SGML
> docs...

Please do.  But note that the first thing I'd add to such a document
would be not to write things like that:

    You should <command>VACUUM</command> your database every day.

Instead, either write

    You should vacuum your database every day.

or

    You should run the command <command>VACUUM</command> in your
    database every day.

If you need a verb, write a verb; don't abuse nouns.


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

Предыдущее
От: Peter Eisentraut
Дата:
Сообщение: Re: improvements to SGML
Следующее
От: Peter Eisentraut
Дата:
Сообщение: Re: make "wal_debug" GUC var a boolean