Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 28 Jul 2004 21:52:48 +0100
From:      Ceri Davies <ceri@FreeBSD.org>
To:        doc@FreeBSD.org
Subject:   <section> vs. <sectN>
Message-ID:  <20040728205248.GI424@submonkey.net>

next in thread | raw e-mail | index | archive | help

--YrlhzR9YrZtruaFS
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable


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
--=20
It is not tinfoil, it is my new skin.  I am a robot.

--YrlhzR9YrZtruaFS
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (FreeBSD)

iD8DBQFBCBIfocfcwTS3JF8RAjN1AJ937cgr1dpZKoKvFa0knZuUph1rtwCeIaEe
l4CK1IN5e79rpgsn0eatIxU=
=H8wC
-----END PGP SIGNATURE-----

--YrlhzR9YrZtruaFS--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040728205248.GI424>