Re: Adding an table of contents in SGML

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Adding an table of contents in SGML
Date: 2009-03-31 02:33:49
Message-ID: 200903310233.n2V2Xnb02553@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > I would like to add a table of contents to the top of the 8.4 release
> > notes:
>
> Resist the temptation. If you have so many sub-sections that it needs
> its own table of contents, you have too many.

It is not that things are hard to find but rather that it would be good
to present a list at the top to give users a better handle on the
contents; there are 276 items listed in the 8.4 release notes. 8.3 had
237, a 15% increase.

> > Similar to the one at the top here:
> > http://developer.postgresql.org/pgdocs/postgres/datatype.html
>
> That is a chapter heading, not a section heading.

True, but it says, "Table of Contents", at the top of the list of
headings.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Mario Splivalo 2009-03-31 11:09:03 Re: Array functions not mentioned in Index
Previous Message Tom Lane 2009-03-31 02:28:29 Re: Adding an table of contents in SGML