On Thu, 2004-08-12 at 19:01, Karsten Wade wrote:
For maintainability sake, it might be easier to keep things separate. Either way, we could have a document set that covers multiple methods. Fedora Doc Set: Hot Plugging or something.
Due care when authoring Paul? E.g. if the different ways are at <sect1> level, its no problem to merge or separate them? 'nother benefit of XML?
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.
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>.
Cheers, Mark
-- ---------------------------------------------------------- Mark Johnson <mjohnson@xxxxxxxxxx> Red Hat Documentation Group <http://www.redhat.com> Tel: 919.754.4151 Fax: 919.754.3708 GPG fp: DBEA FA3C C46A 70B5 F120 568B 89D5 4F61 C07D E242
