I second Eliot’s recommendation for formalizing the “sections” for the content models.
Thanks and best regards,
--Scott Scott Hudson | PELCO by Schneider Electric | United States | Standards Lead Phone: +1 970 282 1952 | Mobile: +1 720 369 2433 | Email: scott.hudson@schneider-electric.com
RelaxNG includes the element <div>, which, like HTML and DITA 1.3, provides a generic wrapper you can put around anything.
In the context of DITA modules, <div> could be used to formalize the “sections” that are required by the coding requirements. For example, you could have something like this:
<grammar> <div> <a:documentation> <!-- ============================================================= --> <!-- ROOT ELEMENT DECLARATION --> <!-- ============================================================= --> </a:documentation> … </div> <a:documentation> <!-- ============================================================= --> <!-- MODULE INCLUSIONS --> <!-- ============================================================= --> </a:documentation>
…
</grammar>
This approach would make the RNG files more formally structured and easier to work with in XML editors.
The cost is a bit more verbosity required—we have established a principle of defining non-optional rules for the coding patterns in order to make it more likely that declaration modules can be read and generated by tools and just to reduce options people have to think about or understand. So the spec need to say “you MUST use <div>” rather than “you MAY use div”.
My general inclination as an XML head is that more structure is better, but I wanted to see if anyone felt that use of <div> in this way would be inappropriate or otherwise impose effort without sufficient value.
I will observe that the DocBook 5.x RNG grammars, which are hand-authored, use <div>, so there is a relevant precedent.
E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com
______________________________________________________________________ This email has been scanned by the Symantec Email Security.cloud service. ______________________________________________________________________
|