<section> vs. <sectN>

John Baldwin jhb at FreeBSD.org
Mon Aug 2 14:26:47 UTC 2004


On Friday 30 July 2004 10:15 am, Ceri Davies wrote:
> On Wed, Jul 28, 2004 at 09:52:48PM +0100, Ceri Davies 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.
>
> I sense a lack of consensus, so I won't change this particular document.
> Thanks all,

?? It seems that the consensus is for 2).  The only person in favor of 1) is 
DES on the basis that <sectX> is deprecated.  A quick check to see if it is 
indeed deprecated or not should be sufficient to clear this up.

-- 
John Baldwin <jhb at FreeBSD.org>  <><  http://www.FreeBSD.org/~jhb/
"Power Users Use the Power to Serve"  =  http://www.FreeBSD.org



More information about the freebsd-doc mailing list