<section> vs. <sectN>
Tom Rhodes
trhodes at FreeBSD.org
Wed Jul 28 21:26:50 UTC 2004
On Wed, 28 Jul 2004 21:52:48 +0100
Ceri Davies <ceri at freebsd.org> wrote:
>
> Which of these do we prefer?
>
> 1) <section>
> <para>foo</para>
> <section>
> <para>bar</para>
> </section>
> </section>
>
> 2) <sect1>
> <para>foo</para>
> <sect2>
> <para>bar</para>
> </sect2>
> </sect1>
>
> This is basically a style issue, as DocBook does the same for both, so
> whatever the outcome it should probably be added to the FDP.
>
> I'll note here that nearly all of our documents use #2 already; I am
> working on one of the ones that doesn't.
While I know that DocBook supports both forms, at least from
the last *I* checked. Last time I checked == a long time ago.
My vote will be for the latter of these two examples, fewer
meaningless changes later.
--
Tom Rhodes
More information about the freebsd-doc
mailing list