<section> vs. <sectN>

Murray Stokely murray at FreeBSD.org
Sun Aug 1 06:21:01 UTC 2004


On Thu, Jul 29, 2004 at 01:01:00AM +0200, Marc Fonvieille wrote:
> > 2) <sect1>
> >      <para>foo</para>
> >      <sect2>
> >        <para>bar</para>
> >      </sect2>
> >    </sect1>
> >
> [...]
> 
> The 2nd one is maybe better when it comes to think about indentation
> levels.  And when you are reading a large SGML file it can be useful to
> know "where" a section will be rendered, even if the indentation is not
> correct you know where you are, with 1st form it may be more difficult.

Yes I agree that the second is better.  I have done my fair share of
moving around <sectN>s to different levels, and the effort in changing
two characters in that instance is well worth the enhanced readability
over just <section> tags.

     - Murray



More information about the freebsd-doc mailing list