Date: Wed, 28 Jul 2004 22:57:54 +0200 From: Remko Lodder <remko@elvandar.org> To: Ceri Davies <ceri@FreeBSD.org> Cc: doc@FreeBSD.org Subject: Re: <section> vs. <sectN> Message-ID: <41081352.8050708@elvandar.org> In-Reply-To: <20040728205248.GI424@submonkey.net> References: <20040728205248.GI424@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
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@elvandar.org Reporter DSINet |remko@dsinet.org Projectleader Mostly-Harmless |remko@mostly-harmless.nl
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?41081352.8050708>