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

Re: vacuum and routine maintenance docs

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Scott Marlowe <smarlowe(at)g2switchworks(dot)com>
Cc: "Jim C(dot) Nasby" <jnasby(at)pervasive(dot)com>, pgsql-docs(at)postgresql(dot)org
Subject: Re: vacuum and routine maintenance docs
Date: 2006-01-19 00:55:07
Message-ID: 5713.1137632107@sss.pgh.pa.us (view raw or flat)
Thread:
Lists: pgsql-docs
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?

			regards, tom lane

In response to

Responses

pgsql-docs by date

Next:From: Jim C. NasbyDate: 2006-01-19 01:14:22
Subject: Re: vacuum and routine maintenance docs
Previous:From: Jeff FrostDate: 2006-01-18 23:28:51
Subject: Re: vacuum and routine maintenance docs

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