Обсуждение: Release notes in appendix?
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@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
Bruce Momjian <bruce@momjian.us> 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
Tom Lane wrote: > Bruce Momjian <bruce@momjian.us> 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@momjian.us> http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. +
Bruce Momjian wrote: > Tom Lane wrote: > > Bruce Momjian <bruce@momjian.us> 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
Alvaro Herrera <alvherre@commandprompt.com> 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