public inbox for [email protected]  

help / color / mirror / Atom feed

From: Tom Lane <[email protected]>
To: Scott Marlowe <[email protected]>
Cc: Jim C. Nasby <[email protected]>
Cc: [email protected]
Subject: Re: vacuum and routine maintenance docs
Date: Wed, 18 Jan 2006 19:55:07 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>

Scott Marlowe <[email protected]> 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

view thread (23+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: vacuum and routine maintenance docs
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox