X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id CC22F9DC98D for ; Wed, 18 Jan 2006 21:31:32 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 27809-09 for ; Wed, 18 Jan 2006 21:31:36 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from noel.decibel.org (noel.decibel.org [67.100.216.10]) by postgresql.org (Postfix) with ESMTP id A19A69DC9EC for ; Wed, 18 Jan 2006 21:31:30 -0400 (AST) Received: by noel.decibel.org (Postfix, from userid 1001) id A2A9F3982E; Wed, 18 Jan 2006 19:31:34 -0600 (CST) Date: Wed, 18 Jan 2006 19:31:34 -0600 From: "Jim C. Nasby" To: Tom Lane Cc: Scott Marlowe , pgsql-docs@postgresql.org Subject: Re: vacuum and routine maintenance docs Message-ID: <20060119013134.GR17896@pervasive.com> References: <1137518049.25500.27.camel@state.g2switchworks.com> <20060117224941.GI17896@pervasive.com> <1137538769.25500.49.camel@state.g2switchworks.com> <20060118221951.GT17896@pervasive.com> <1137626008.25500.90.camel@state.g2switchworks.com> <5713.1137632107@sss.pgh.pa.us> <20060119011422.GM17896@pervasive.com> <5896.1137633556@sss.pgh.pa.us> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <5896.1137633556@sss.pgh.pa.us> X-Operating-System: FreeBSD 6.0-RELEASE amd64 X-Distributed: Join the Effort! http://www.distributed.net User-Agent: Mutt/1.5.11 X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.096 required=5 tests=[AWL=0.096] X-Spam-Score: 0.096 X-Spam-Level: X-Archive-Number: 200601/41 X-Sequence-Number: 3431 On Wed, Jan 18, 2006 at 08:19:16PM -0500, Tom Lane wrote: > "Jim C. Nasby" writes: > > I'm wondering if people feel this is an issue with the docs in general > > and isn't limited to just the admin stuff? > > Probably, but the admin stuff seems to suffer worst. In any case, Scott > volunteered to look at redoing that part, and I'm not going to repay the > offer by asking him to redo the whole manual ;-) Certainly true. :) But if we're going to start at an outline level I think it would be enlightening to do a short (as in only 2 levels deep) re-outline of all the docs and see how it compares to what we have. It would at least indicate things that should be wholesale moved out of the admin section... Plus hopefully we could get others to help. :) I'd certainly lend a hand. Is there an easy way to get a 2-level outline out of the sgml? -- Jim C. Nasby, Sr. Engineering Consultant jnasby@pervasive.com Pervasive Software http://pervasive.com work: 512-231-6117 vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461