[DOCS] Release notes in appendix?

2009-06-05 Thread Bruce Momjian
Right now our release notes are in the documentation appendix:

http://developer.postgresql.org/pgdocs/postgres/appendixes.html

The number and size of the release notes really overwhelms the section. 
I am wondering if we should move the release notes out into its own
upper section.

-- 
  Bruce Momjian  http://momjian.us
  EnterpriseDB http://enterprisedb.com

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

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] Release notes in appendix?

2009-06-05 Thread Tom Lane
Bruce Momjian  writes:
> Right now our release notes are in the documentation appendix:
>   http://developer.postgresql.org/pgdocs/postgres/appendixes.html
> The number and size of the release notes really overwhelms the section. 
> I am wondering if we should move the release notes out into its own
> upper section.

I think they are in the right place logically.  If you feel they are
getting too big, maybe it's time to discuss dropping the oldest
information.

regards, tom lane

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] Release notes in appendix?

2009-06-05 Thread Bruce Momjian
Tom Lane wrote:
> Bruce Momjian  writes:
> > Right now our release notes are in the documentation appendix:
> > http://developer.postgresql.org/pgdocs/postgres/appendixes.html
> > The number and size of the release notes really overwhelms the section. 
> > I am wondering if we should move the release notes out into its own
> > upper section.
> 
> I think they are in the right place logically.  If you feel they are
> getting too big, maybe it's time to discuss dropping the oldest
> information.

OK, let's just leave it then.  It seemed to me the release notes were
burried among other unrelated items but if you think they look OK we can
just leave them there.

-- 
  Bruce Momjian  http://momjian.us
  EnterpriseDB http://enterprisedb.com

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

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] Release notes in appendix?

2009-06-05 Thread Alvaro Herrera
Bruce Momjian wrote:
> Tom Lane wrote:
> > Bruce Momjian  writes:
> > > Right now our release notes are in the documentation appendix:
> > >   http://developer.postgresql.org/pgdocs/postgres/appendixes.html
> > > The number and size of the release notes really overwhelms the section. 
> > > I am wondering if we should move the release notes out into its own
> > > upper section.
> > 
> > I think they are in the right place logically.  If you feel they are
> > getting too big, maybe it's time to discuss dropping the oldest
> > information.
> 
> OK, let's just leave it then.  It seemed to me the release notes were
> burried among other unrelated items but if you think they look OK we can
> just leave them there.

Another idea would be to turn each major version into its own ,
and have minor versions as  instead (so for example we would have
release-8-3-6 as sect2, not sect1).

-- 
Alvaro Herrerahttp://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] Release notes in appendix?

2009-06-05 Thread Tom Lane
Alvaro Herrera  writes:
> Another idea would be to turn each major version into its own ,
> and have minor versions as  instead (so for example we would have
> release-8-3-6 as sect2, not sect1).

Hmm, but then what do we do with the subsections of the major-release
notes?  I guess they'd end up on the same level as the minor release
headers, which doesn't seem very helpful.

regards, tom lane

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs