Re: Documentation of pg_badkend_pid and stats functions

Поиск
Список
Период
Сортировка
От Jim Nasby
Тема Re: Documentation of pg_badkend_pid and stats functions
Дата
Msg-id B4117EF4-2CFE-401B-9C8E-B18A51FA556B@decibel.org
обсуждение исходный текст
Ответ на Re: Documentation of pg_badkend_pid and stats functions  (Tom Lane <tgl@sss.pgh.pa.us>)
Ответы Re: Documentation of pg_badkend_pid and stats functions  (Bruce Momjian <bruce@momjian.us>)
Список pgsql-docs
On May 13, 2007, at 6:45 PM, Tom Lane wrote:
> "Jim C. Nasby" <decibel@decibel.org> writes:
>> On Sun, May 13, 2007 at 06:48:01PM -0400, Tom Lane wrote:
>>> Surely a section should not *begin* with a cross-reference to
>>> someplace else.
>
>> My concern is that folks will see the table right below it, not find
>> what they're looking for there, and move on... what about immediately
>> after the table?
>
> Immediately after is fine with me.  For that matter, you could
> probably
> get away with putting it between the introductory para and the table
> proper.  I'm just allergic to sections that don't begin with a topic
> sentence telling you what they are about.

See attached. I wanted to not put it between the paragraph
referencing the table and the table itself, but couldn't think of a
better intro paragraph for the section...

--
Jim Nasby                                            jim@nasby.net
EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)



Вложения

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

Предыдущее
От: David Fetter
Дата:
Сообщение: Re: [PATCHES] OS/X startup scripts
Следующее
От: Alvaro Herrera
Дата:
Сообщение: Re: [PATCHES] OS/X startup scripts