<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