<section> vs <sect1>, ... [was: Re: usb-keys]

Dave Pawson davep at dpawson.co.uk
Fri Aug 13 15:14:30 UTC 2004


On Fri, 2004-08-13 at 15:48, Mark Johnson wrote:
> Is there any possibility of revisiting the policy of using <sect1> 
> <sect2>, ..., instead of <section>?
> 
> The latter allows one to move sections around (& in to other docs) 
> much more easily. Also, there's a slight possibility that <sect1>, 
> etc., might disappear when DocBook 5 comes out.

Is there?
I don't think that likely. Even 5 needs some backwards compatibility.
> 
> The fedora docs policy on this is spelled out here:
> 
> http://fedora.redhat.com/participate/documentation-guide/s1-xml-tags-sections.html
> 
> IMO, use of <section> makes a document much more modular, in the 
> sense that it may later be incorporated into another document. I 
> can't recall where, but some 'best practices' presentation/doc I've 
> seen recommends moving to <section>.

Modifying sect1 to section isn't too hard,
and the content models are near as damn it identical Mark?




-- 
Regards DaveP.
XSLT&Docbook  FAQ
http://www.dpawson.co.uk/xsl






More information about the fedora-docs-list mailing list