<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