[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

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



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




[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]