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 200710180606.l9I667005711@momjian.us
Whole thread Raw
In response to Re: pgsql: First pass over release documentation.  (Neil Conway <neilc@samurai.com>)
Responses Re: pgsql: First pass over release documentation.  (Neil Conway <neilc@samurai.com>)
List pgsql-committers
Neil Conway wrote:
> On Thu, 2007-10-18 at 01:53 -0400, Bruce Momjian wrote:
> > The overview descriptions were moved down to the body of the release
> > notes.
>
> ... which makes the overview descriptions too vague to be very useful,
> in some cases. The "Migration to version 8.3" section is also NOT the
> place to be eliding details. You've also removed other useful details
> from the rest of the release notes -- although the fact that this was
> done as one giant commit means it is rather hard to review :-(

I have made the details match what we usually do for level of detail in
the release notes.  We can change that, of course, but have not had
problems in the past.

> >   As far as the uppercase of type names, I though most SQL code
> > uppercased them.
>
> Perhaps, but I think we should be consistent with the convention used
> elsewhere in the SGML documentation.

I guess.

--
  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: neilc@postgresql.org (Neil Conway)
Date:
Subject: pgsql: Minor fixes for the release notes.