Release notes in appendix?

[Bruce Momjian-5]

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  <bruce@...>        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 (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[Tom Lane-2]

Bruce Momjian <bruce@...> 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 (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[Bruce Momjian-5]

Tom Lane wrote:

> Bruce Momjian <bruce@...> 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  <bruce@...>        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 (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[Alvaro Herrera-7]

Bruce Momjian wrote:

> Tom Lane wrote:
> > Bruce Momjian <bruce@...> 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 <sect1>,
and have minor versions as <sect2> instead (so for example we would have
release-8-3-6 as sect2, not sect1).

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

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

[Tom Lane-2]

Alvaro Herrera <alvherre@...> writes:
> Another idea would be to turn each major version into its own <sect1>,
> and have minor versions as <sect2> 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 (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs