[EMAIL PROTECTED] 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
_______________________________________________
Zope3-dev mailing list
[email protected]
Unsub: http://mail.zope.org/mailman/options/zope3-dev/archive%40mail-archive.com
