[Product-Developers] [ANN] aws.zope2zcmldoc

Alex Clark aclark at aclark.net
Thu Apr 21 01:42:51 UTC 2011

On 4/20/11 6:54 PM, Maurits van Rees wrote:
> Op 18-04-11 14:59, Gilles Lenfant schreef:
>> Hello folks,
>> I'm pleased to announce the birth of aws.zope2zcmldoc
>> http://pypi.python.org/pypi/aws.zope2zcmldoc/
>> https://svn.plone.org/svn/collective/aws.zope2zcmldoc
>> aws.zope2zcmldoc adds a new Zope control panel that shows the doc of
>> the various ZCML directives available in your instance. This component
>> is clearly a companion for your development instance beside
>> DocFinderTab, Clouseau, plone.reload.
>> Though I consider it as alfaware, this component has no side effect on
>> applications or in the ZCML behaviour. The layout is at the moment
>> somehow spartan and will be improved in the future releases.
>> Thanks in advance for any hint, feedback, feature idea, patch (...)
> Looks useful, thanks!
> Tested and found working in Ploen 4.0 (Zope 2.12) and Plone 4.1 (Zope
> 2.13). I saw a remark on Plone 4.0 that the zcml namespace could for
> some reason not be shown. On 4.1 this *is* shown (maybe something was
> fixed in its registration), although the zcml:condition directive is not
> shown. I guess that is something that cannot be fixed in
> aws.zope2zcmldoc though.
> Oh, can I suggest adding a z3c.autoinclude entry point for plone so the
> zcml gets picked up automatically on Plone 3.3 and higher? IIUC your
> package works with plain Zope2 without Plone as well, but having an
> entry point for plone does not hurt that use case.


This is a very cool developer add-on, thank you Gilles!

A few nits:

- You made me read the docs ;-p (i.e. to find out I had to run 
@@install-aws-zope2zcmldoc), any way to automate this?

- I originally expected a "ZCML doc" tab next to the DocFinderTab tab to 
show up, and I'd express a preference for it to be there (instead of the 
in the Control_Panel), but perhaps placefulness doesn't make any sense 
in the context of ZCML.


> Thanks,

Alex Clark · http://aclark.net/training

More information about the Product-Developers mailing list