Date: Wed, 3 Jul 2013 04:10:49 -0430 From: Alberto Mijares <amijaresp@gmail.com> To: Gabor Kovesdan <gabor@freebsd.org> Cc: doc@freebsd.org Subject: Re: RFC: Upgrading to DocBook 5.0 Message-ID: <CAGZBXN8dLmf6iuCpD4cw5zbOP-NLj%2BRqqxtndRa9rAvScSo3Ag@mail.gmail.com> In-Reply-To: <51D3E051.5070506@FreeBSD.org> References: <519FA4FE.4030305@FreeBSD.org> <51D3E051.5070506@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
IMHO, is a good thing to keep a visual clue of the level you are going down while writing. So, <sect[123...]> should be kept, I think. Regards Alberto Mijares On Wed, Jul 3, 2013 at 3:56 AM, Gabor Kovesdan <gabor@freebsd.org> 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"
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAGZBXN8dLmf6iuCpD4cw5zbOP-NLj%2BRqqxtndRa9rAvScSo3Ag>