[Zope3-dev] Re: ZCML bad ;-)

[Benji York]

cstrong at arielpartners.com wrote:
 > I like generating documentation directly from source.
 > Namespaces provide a nice way to do that with XML files via XSLT, while
 > still enabling RelaxNG schema validation, etc.

 > <z:directive>
 >   <z:name>foo</z:name>
 >   <a:documentation>
 >    The foo directive indicates that the bar setting should be wombat.
 >    This is important when...
 >   </a:documentation>
 > </z:directive>

what are the advantages of that approach over something like this:

<z:directive>

   <z:name>foo</z:name>
     The foo directive indicates that the bar setting should be wombat.
     This is important when...

</z:directive>

I.e. just intermingle prose with the ZCML.
-- 
Benji York
Senior Software Engineer
Zope Corporation