Re: [docbook] Best Practice in using sect1 - sect5

[Aankhen <aankhen@gmail.com>]

On Wed, May 18, 2011 at 21:38, Rowland, Larry <larry.rowland@hp.com> wrote:
> I frequently do manpages using DocBook for creating them. Â I find
> that knowing how many sections I am nested in is very valuable and
> that is what refsect1, refsect2, etc is very valuable for, since
> the NROFF that all of them are rendered through in a term window
> does not provide coding for headings below a fixed level. Â We also
> have rules about depth of nesting of sections in nodes in help
> systems; again, having explicit sect1, sect2 provides very clear
> indication of how deeply nested the sections are.
>
> While I frequently use nested section elements in documents for
> which depth of nesting is not an issue, having the flexibility to
> know precisely how deeply my sections are nested is important in
> some cases. Â Not everyone doing technical documentation is doing
> the same thing. Â Simplify the schema as much as you want for your
> own use, but don't handicap the people who need a richer expression
> in the markup.

How deeply your sections are nested is something that your tools ought
to be telling you, not something that the schema should have to lay
out…

Aankhen