Re: Outline numbering

[Alexander Kirillov <kirillov math sunysb edu>]

This is a matter of personal preference. I find it more convenient
to have outline numbering - at least, have numbers for <chapter> and
<sect1>. This makes it easier to refer to them when discussing docs
with someone (e.g., when I send comments to other authors or when I
answer users' questions). On the other hand, I do not think it makes
sense to number <sect2> and below.

Sasha

On Thu, Jul 04, 2002 at 02:40:55PM +0100, Eugene O'Connor wrote:
> Hello all,
> 
> Presently Yelp renders the online help with outline numbering. That is,
> like this:
> 
> 1.1. Opening an Accessibility Tool
> 1.2. Configuring Keyboard Accessibility Options
>      1.2.1. Keyboard Accessibility Options
>      1.2.2. Miscellaneous Accessibility Options
> 
> rather than like this:
> 
> Opening an Accessibility Tool
> Configuring Keyboard Accessibility Options
>    Keyboard Accessibility Options
>    Miscellaneous Accessibility Options
> 
> I don't think we should use outline numbering when we are only ever
> showing chapters of the User Guide or small manuals in Yelp. I don't
> think they're useful in this context. What do other people think?
> 
> Eugene
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list