<section> vs. <sectN>

Remko Lodder remko at elvandar.org
Wed Jul 28 20:57:57 UTC 2004


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

Heya Ceri,

Personally i like the sect1 and sect2 better, since they are more clear 
for me that a section starts and ends, section and section could give 
confusion if not properly indented...

So, i prefer sect1 and sect2, if you think section and section are more 
clear, make sure the rules about indenting are 100% followed or things 
might get confusing :)

Cheers!


-- 
Kind regards,

Remko Lodder                   |remko at elvandar.org
Reporter DSINet                |remko at dsinet.org
Projectleader Mostly-Harmless  |remko at mostly-harmless.nl



More information about the freebsd-doc mailing list