public inbox for [email protected]  

help / color / mirror / Atom feed

From: Bruce Momjian <[email protected]>
To: Tom Lane <[email protected]>
Cc: PostgreSQL-documentation <[email protected]>
Subject: Re: Adding an table of contents in SGML
Date: Mon, 30 Mar 2009 22:33:49 -0400 (EDT)
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>

Tom Lane wrote:
> Bruce Momjian <[email protected]> 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  <[email protected]>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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

view thread (4+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: Adding an table of contents in SGML
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox