From owner-freebsd-doc@FreeBSD.ORG  Wed Jul 28 20:57:57 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 1B3AF16A4CE; Wed, 28 Jul 2004 20:57:57 +0000 (GMT)
Received: from redqueen.elvandar.org (cust.94.120.adsl.cistron.nl
	[195.64.94.120])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 69D2843D53; Wed, 28 Jul 2004 20:57:56 +0000 (GMT)
	(envelope-from remko@elvandar.org)
Received: from [10.0.2.122] (nimrod.elvandar.intranet [10.0.2.122])
	by redqueen.elvandar.org (Postfix) with ESMTP id 31D5D10685E;
	Wed, 28 Jul 2004 22:57:52 +0200 (CEST)
Message-ID: <41081352.8050708@elvandar.org>
Date: Wed, 28 Jul 2004 22:57:54 +0200
From: Remko Lodder <remko@elvandar.org>
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Ceri Davies <ceri@FreeBSD.org>
References: <20040728205248.GI424@submonkey.net>
In-Reply-To: <20040728205248.GI424@submonkey.net>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-Virus-Scanned: by amavisd-new at elvandar.org
cc: doc@FreeBSD.org
Subject: Re: <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:57:57 -0000

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