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