[Zope3-dev] Re: [Zope3-checkins] CVS: Zope3/src/zope/app/browser/services - add_svc_config.pt:1.2 useconfiguration.pt:1.2 useconfiguration.py:1.2 configure.zcml:1.21 service.py:1.7 add_service_1.pt:NONE add_service_2.pt:NONE

[Jeffrey P Shell]

On Wednesday, March 5, 2003, at 08:10  AM, Jim Fulton wrote:

> This isn't about saving typing. It's about visual clutter, IMO::
>
>   <pages
>       for="zope.app.interfaces.annotation.IAnnotatable"
>       permission="zope.ManageContent"
>       class="zope.app.browser.dublincore.metadataedit.MetaDataEdit"
>       >
>     <page name="EditMetaData.html" template="edit.pt" />
>     <page name="MetaDataBox" template="box.pt" />
>   </pages>
>
> is more readable than:
>
>   <browser:pages
>       for="zope.app.interfaces.annotation.IAnnotatable"
>       permission="zope.ManageContent"
>       class="zope.app.browser.dublincore.metadataedit.MetaDataEdit"
>       >
>     <browser:page name="EditMetaData.html" template="edit.pt" />
>     <browser:page name="MetaDataBox" template="box.pt" />
>   </browser:pages>
>
> The "browser:" is a visual obstical I have to scan past to see the
> directive name.

As someone who has spent far less time working with ZCML, 'browser:' is 
a visual cue that helps me understand the directive more without having 
to be imbued in the surrounding context of the directive.

> But perhaps the majority disagree, in which case, I'd be happy
> to require the more verbose form.