From owner-freebsd-doc@FreeBSD.ORG  Wed Jul 28 20:52:51 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id DD54816A4CE
	for <doc@FreeBSD.org>; Wed, 28 Jul 2004 20:52:51 +0000 (GMT)
Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com
	[81.103.67.204])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9B5ED43D68
	for <doc@FreeBSD.org>; Wed, 28 Jul 2004 20:52:51 +0000 (GMT)
	(envelope-from setantae@submonkey.net)
Received: from setantae by shrike.submonkey.net with local (Exim 4.41
	(FreeBSD))	id 1BpvPs-0006Cl-4e
	for doc@FreeBSD.org; Wed, 28 Jul 2004 21:52:48 +0100
Date: Wed, 28 Jul 2004 21:52:48 +0100
From: Ceri Davies <ceri@FreeBSD.org>
To: doc@FreeBSD.org
Message-ID: <20040728205248.GI424@submonkey.net>
Mail-Followup-To: Ceri Davies <ceri@FreeBSD.org>, doc@FreeBSD.org
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="YrlhzR9YrZtruaFS"
Content-Disposition: inline
X-PGP: finger ceri@FreeBSD.org
User-Agent: Mutt/1.5.6i
Sender: Ceri Davies <setantae@submonkey.net>
Subject: <section> vs. <sectN>
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 28 Jul 2004 20:52:52 -0000


--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--