Re: Adding an table of contents in SGML - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Adding an table of contents in SGML
Date
Msg-id 200903310233.n2V2Xnb02553@momjian.us
Whole thread Raw
In response to Re: Adding an table of contents in SGML  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
Tom Lane wrote:
> Bruce Momjian <bruce@momjian.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@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Adding an table of contents in SGML
Next
From: Mario Splivalo
Date:
Subject: Re: Array functions not mentioned in Index