<section> vs. <sectN>
Denis Peplin
den at FreeBSD.org
Thu Jul 29 05:25:39 UTC 2004
Hello!
For me 1'st variant looks better.
For example i can skip whole sect1 on first
updating and then include it by searching /sect1
once.
With section's search will stop on each section
included (currently sect2, sect3, sect4) many times.
just my $0.02 :)
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.
>
> Ceri
More information about the freebsd-doc
mailing list