<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