Re: Documentation of pg_badkend_pid and stats functions

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: "Jim C(dot) Nasby" <decibel(at)decibel(dot)org>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Documentation of pg_badkend_pid and stats functions
Date: 2007-05-13 23:45:30
Message-ID: 21498.1179099930@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

"Jim C. Nasby" <decibel(at)decibel(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2007-05-14 01:04:53 Re: [GENERAL] PITR and tar
Previous Message Andrew Dunstan 2007-05-13 23:04:44 Re: [PATCHES] OS/X startup scripts