Date: Wed, 28 Jul 2004 17:27:18 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Ceri Davies <ceri@FreeBSD.org> Cc: doc@FreeBSD.org Subject: Re: <section> vs. <sectN> Message-ID: <20040728172718.3bb7f557@localhost> In-Reply-To: <20040728205248.GI424@submonkey.net> References: <20040728205248.GI424@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 28 Jul 2004 21:52:48 +0100 Ceri Davies <ceri@freebsd.org> 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. While I know that DocBook supports both forms, at least from the last *I* checked. Last time I checked == a long time ago. My vote will be for the latter of these two examples, fewer meaningless changes later. -- Tom Rhodes
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040728172718.3bb7f557>