Re: easier navigation in manuals, and manuals that subdivide

[Matthew Paul Thomas <mpt myrealbox com>]

On Aug 1, 2006, at 8:53 AM, Joachim Noreiko wrote:
> ...
> So I see two ways forward for manuals that are
> starting to get unwieldy (as a stopgap until Mallard,
> of course) -- examples include gucharmap, gedit, and
> more.
>
> A. replace top-level <section> with <chapter>
> B. Kill any section that is called "Usage" and split
> it into sections with informative names. Impose
> ourselves a rough limit on the number of subtopics
> within any top-level section.
>
> Thoughts?
> ...

Perhaps the best choice depends on how many parts there are. If there 
are fewer than, say, 20 of them, make them all <chapter>s. If there are 
more, start grouping related <section>s in <chapter>s.

--
Matthew Paul Thomas
http://mpt.net.nz/