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

From Neil Conway
Subject Re: pgsql: First pass over release documentation.
Date
Msg-id 1192688226.10573.21.camel@goldbach
Whole thread Raw
In response to Re: pgsql: First pass over release documentation.  (Bruce Momjian <bruce@momjian.us>)
Responses Re: pgsql: First pass over release documentation.  (Bruce Momjian <bruce@momjian.us>)
List pgsql-committers
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.

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).

Beyond those two sections, I still think you've removed quite a lot of
useful information in the rest of the release notes.

-Neil



pgsql-committers by date:

Previous
From: neilc@postgresql.org (Neil Conway)
Date:
Subject: pgsql: Minor fixes for the release notes.
Next
From: Bruce Momjian
Date:
Subject: Re: pgsql: First pass over release documentation.