From: | "Jim C(dot) Nasby" <jnasby(at)pervasive(dot)com> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | Scott Marlowe <smarlowe(at)g2switchworks(dot)com>, pgsql-docs(at)postgresql(dot)org |
Subject: | Re: vacuum and routine maintenance docs |
Date: | 2006-01-19 01:14:22 |
Message-ID: | 20060119011422.GM17896@pervasive.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Wed, Jan 18, 2006 at 07:55:07PM -0500, Tom Lane wrote:
> Scott Marlowe <smarlowe(at)g2switchworks(dot)com> writes:
> > Well, I'm kind of tempted to rewrite the whole section. I'd like to
> > come up with some objectives of what we're trying to cover there, and
> > basically start over with all the information that's there plus the
> > other stuff on fsm and mvcc as it applies to vacuum, or link to it as
> > needed.
>
> > To me, the docs feel kind of like they've evolved over time, so the
> > ordering and general layout feel klunky. No slam on the folks who wrote
> > them to start with, or updated them. Just makes my tech docs training
> > come out.
>
> You're certainly right about the history of the docs, and I agree that a
> ground-up rewrite is the only thing that would help much --- trying to
> incorporate new separately-written material is just going to be "more of
> the same", ISTM, no matter how good that material might be on its own.
>
> Is it reasonable to try to make an outline of how you think the chapter
> should go, or would that be premature without more discussion of
> objectives?
I'm wondering if people feel this is an issue with the docs in general
and isn't limited to just the admin stuff?
I know I certainly have trouble finding things... I generally look for
stuff by going to the appropriate page in the SQL syntax section and
seeing what it links too, but of course there's a lot of things that
aren't (and shouldn't be) linked to from there...
--
Jim C. Nasby, Sr. Engineering Consultant jnasby(at)pervasive(dot)com
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2006-01-19 01:19:16 | Re: vacuum and routine maintenance docs |
Previous Message | Tom Lane | 2006-01-19 00:55:07 | Re: vacuum and routine maintenance docs |