Re: pgsql: First pass over release documentation. - Mailing list pgsql-committers

From Bruce Momjian
Subject Re: pgsql: First pass over release documentation.
Date
Msg-id 200710180621.l9I6Lcj15345@momjian.us
Whole thread Raw
In response to Re: pgsql: First pass over release documentation.  (Neil Conway <neilc@samurai.com>)
List pgsql-committers
Neil Conway wrote:
> On Thu, 2007-10-18 at 02:06 -0400, Bruce Momjian wrote:
> > I have made the details match what we usually do for level of detail in
> > the release notes.
>
> WRT the overview, I'm not sure what a user is supposed to make of an
> overview bullet point like "Use pseudo-transaction ids in read-only
> transactions". If we're going to mention this at all, we ought to
> include enough information for it to be sensible -- or else phrase it in
> less technical terms ("Improve performance of read-only transactions by
> lazily assigning transaction IDs"). Similar comments apply to the "ORDER
> BY ... LIMIT" optimization, async commit, distributed checkpoint I/O,
> etc.

Agreed.  I need to make it more targeted at the benefit, like "reduce
need for vacuuming caused by read-only transactions".  You are looking
at only my first cut at edits.

> For the "Migration to 8.3" section, I think we definitely need a lot
> more details than are presently there ("New C macros for handling
> variable-length data values" is not exactly very useful, for example).

The detail is below.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://postgres.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

pgsql-committers by date:

Previous
From: Neil Conway
Date:
Subject: Re: pgsql: First pass over release documentation.
Next
From: Bruce Momjian
Date:
Subject: Re: pgsql: First pass over release documentation.