Re: Documentation of pg_badkend_pid and stats functions - Mailing list pgsql-docs

From Tom Lane
Subject Re: Documentation of pg_badkend_pid and stats functions
Date
Msg-id 21498.1179099930@sss.pgh.pa.us
Whole thread Raw
In response to Re: Documentation of pg_badkend_pid and stats functions  ("Jim C. Nasby" <decibel@decibel.org>)
Responses Re: Documentation of pg_badkend_pid and stats functions
List pgsql-docs
"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.

            regards, tom lane

pgsql-docs by date:

Previous
From: Andrew Dunstan
Date:
Subject: Re: [PATCHES] OS/X startup scripts
Next
From: Bruce Momjian
Date:
Subject: Re: [GENERAL] PITR and tar