Re: pgsql: First pass over release documentation.

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