Received: from localhost (postgresql.org [64.49.215.8])
	by postgresql.org (Postfix) with ESMTP
	id 1AFF047616D; Sun, 20 Oct 2002 22:27:08 -0400 (EDT)
Received: from sss.pgh.pa.us (unknown [192.204.191.242])
	by postgresql.org (Postfix) with ESMTP
	id 734194760AA; Sun, 20 Oct 2002 22:27:06 -0400 (EDT)
Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1])
	by sss.pgh.pa.us (8.12.5/8.12.5) with ESMTP id g9L2R2hR016163;
	Sun, 20 Oct 2002 22:27:02 -0400 (EDT)
To: Bruce Momjian <pgman@candle.pha.pa.us>
Cc: Vince Vielhaber <vev@michvhf.com>, pgsql-docs@postgresql.org,
	pgsql-hackers@postgresql.org
Subject: Re: [HACKERS] reminder for those working on docs 
In-reply-to: <200210210218.g9L2Iqw13272@candle.pha.pa.us> 
References: <200210210218.g9L2Iqw13272@candle.pha.pa.us>
Comments: In-reply-to Bruce Momjian <pgman@candle.pha.pa.us>
	message dated "Sun, 20 Oct 2002 22:18:52 -0400"
Date: Sun, 20 Oct 2002 22:27:02 -0400
Message-ID: <16162.1035167222@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
X-Virus-Scanned: by AMaViS new-20020517
X-Archive-Number: 200210/18
X-Sequence-Number: 1512

Bruce Momjian <pgman@candle.pha.pa.us> writes:
> Tom Lane wrote:
>> I've gone through this, and found only a couple of things that seemed
>> worth migrating into the 7.3 docs.  Perhaps I just have a low tolerance
>> for silliness tonight, but it seemed like the average quality of the
>> comments was a lot lower than in previous release cycles :-(

> It is possible our docs are getting clearer and there is less fiddling
> to do.

Or I'm just being a jerk tonight.  Anyone else care to make a pass
through the comments?  It seemed like an awful lot of the stuff that
was credible at all was "point <foo> should be mentioned over here in
part <bar>", which I mostly didn't agree with, but maybe someone else
would see it differently.

			regards, tom lane