Skip site navigation (1) Skip section navigation (2)

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 (view raw or flat)
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

pgsql-docs by date

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

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group