Re: Release Note Changes

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: bruce(at)momjian(dot)us
Cc: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>, Gregory Stark <stark(at)enterprisedb(dot)com>, Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Simon Riggs <simon(at)2ndquadrant(dot)com>, pgsql-hackers(at)postgresql(dot)org
Subject: Re: Release Note Changes
Date: 2007-12-10 23:37:42
Message-ID: 200712102337.lBANbgx09146@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers


Release note introduction attached and applied.

---------------------------------------------------------------------------

bruce wrote:
> Based on this discussion I think it is clear the release notes chapter
> needs an introductory section. This would not be for any specific
> release but the release notes in general. I have come up with the
> following text:
>
> The release notes contain the significant changes for each PostgreSQL
> release, with major features or migration issues often listed at the
> top. The release notes do not contain changes that affect only a few
> users or changes that are internal and therefore not user-visible. For
> example, the optimizer is improved in almost every release, but the
> improvements are usually observed by users as simply faster queries.
>
> A complete list of all changes for a release can only be obtained
> by viewing the CVS logs for each release. The committers email
> list (http://archives.postgresql.org/pgsql-committers/) contains
> all source code changes as well. There is also a web interface
> that shows changes to specific files or directories
> (http://developer.postgresql.org/cvsweb.cgi/pgsql/). (XXX SVN is
> good but needs "Next" button at bottom, no branch filter, https
> certificate update
> https://projects.commandprompt.com/public/pgsql/log/?action=stop_on_copy&rev=&stop_rev=&mode=stop_on_copy&verbose=on).
>
> A names appearing next to an item represents the major developer for
> that item. Of course all changes involve community discussion and patch
> review so each item is truely a community activity. First-name-only
> entries represent established developers, while full names represent
> newer contributors.
>
> I need help with the CVS section. Do we publish full CVS logs for a
> release? I like the SVN display because it groups commits but can
> improvements I listed above be made?
>
> --
> 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. +

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

Attachment Content-Type Size
/rtmp/diff text/x-diff 1.9 KB

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 2007-12-10 23:40:52 Re: Release Note Changes
Previous Message Andrew Chernow 2007-12-10 23:23:53 PGparam proposal