Re: pgsql: First pass over release documentation.

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Neil Conway <neilc(at)samurai(dot)com>
Cc: pgsql-committers(at)postgresql(dot)org
Subject: Re: pgsql: First pass over release documentation.
Date: 2007-10-18 06:06:07
Message-ID: 200710180606.l9I667005711@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: 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(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

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

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Neil Conway 2007-10-18 06:07:23 pgsql: Minor fixes for the release notes.
Previous Message Neil Conway 2007-10-18 06:02:05 Re: pgsql: First pass over release documentation.