[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
Zope3-dev@zope.org
Unsub: http://mail.zope.org/mailman/options/zope3-dev/archive%40mail-archive.com

Reply via email to