From owner-freebsd-doc@FreeBSD.ORG Wed Jul 3 08:40:50 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 07540F95; Wed, 3 Jul 2013 08:40:50 +0000 (UTC) (envelope-from amijaresp@gmail.com) Received: from mail-vc0-x235.google.com (mail-vc0-x235.google.com [IPv6:2607:f8b0:400c:c03::235]) by mx1.freebsd.org (Postfix) with ESMTP id B097215D7; Wed, 3 Jul 2013 08:40:49 +0000 (UTC) Received: by mail-vc0-f181.google.com with SMTP id lf11so3450290vcb.12 for ; Wed, 03 Jul 2013 01:40:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=Gx3QeFQ1EQYsNQB5H8yFV284l/KEoeD+5p9zyrt771c=; b=bDiB7N0vz5cwldt8M+jBwyMaqtA/K4yADY83agA5ZDtIIkuhUDE4Df2l/S48UPkaJd GsMl258bLll0Gzu2SaMYJjt6QdYdT661Rx2XgfrAkn0x/Lyjbk+DhAAkuBib2iKn1lsr GJqcIVMRQoMsrYN2qbBYZ5W5hucoZ3N2nSSEdWTLldKqRIKzOJ/h3kN1JKUXd7lm6XxN tLHpo3/Di0N9HxGti9IPB3TuSFOuZNJNfmx/gMguL8s17LIjWmOBYRZ/zR+lA3WYjAJJ 5/fpDo4Eoh1J+yhlqAz/P4yNGHwBk/fXvHmndVLO8EkEnWDbL+hDHHbxcJBnZXeDwKPr USFQ== MIME-Version: 1.0 X-Received: by 10.58.50.7 with SMTP id y7mr12484916ven.24.1372840849263; Wed, 03 Jul 2013 01:40:49 -0700 (PDT) Received: by 10.58.224.7 with HTTP; Wed, 3 Jul 2013 01:40:49 -0700 (PDT) In-Reply-To: <51D3E051.5070506@FreeBSD.org> References: <519FA4FE.4030305@FreeBSD.org> <51D3E051.5070506@FreeBSD.org> Date: Wed, 3 Jul 2013 04:10:49 -0430 Message-ID: Subject: Re: RFC: Upgrading to DocBook 5.0 From: Alberto Mijares To: Gabor Kovesdan Content-Type: text/plain; charset=UTF-8 Cc: doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 03 Jul 2013 08:40:50 -0000 IMHO, is a good thing to keep a visual clue of the level you are going down while writing. So, should be kept, I think. Regards Alberto Mijares On Wed, Jul 3, 2013 at 3:56 AM, Gabor Kovesdan wrote: > Em 24-05-2013 19:35, Gabor Kovesdan escreveu: >> >> I'm working on upgrading our documentation set to DocBook 5.0 and I'd like >> to discuss some details. We have some customizations and strange uses, which >> can be expressed with DocBook 5.0's own vocabulary. This upgrade is a good >> opportunity to change these, as well. I propose the following changes in our >> vocabulary: > > One more thing to discuss: shall we maintain the sect1, sect2, ... elements > or just use section? The section element can have another section element > embedded and the numbering in the rendered version is inferred by the level > of embedment. This is more uniform and less redundant. In own docs that I > write with DocBook I only use section and it works fine. Opinions? > > Gabor > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"