<section> vs. <sectN>
remko at elvandar.org
Wed Jul 28 20:57:57 UTC 2004
Ceri Davies wrote:
> Which of these do we prefer?
> 1) <section>
> 2) <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.
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 :)
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