[Grok-dev] Naming of grok.provides

[Thomas Lotze]

We recently noticed that the grok.provides directive is not well-named:

The documentation states that "if the local utility implements
more than one interface or if the implemented interface cannot be
determined, grok.provides() is required to disambiguate for what
interface the local utility will be registered."

OTOH, in zope.interface terminology, the term "provides" has a clear
meaning in contrast to "implements": if a class, for instance,
implements a certain interface, its instances are said to provide it.

We feel that something should be done about this contradiction of
terminologies as it confuses not only newcomers to Grok. Beyond a
documentation improvement, what would be an acceptable fix given that
this directive is rather close to Grok's core?

Thomas

-- 
Thomas Lotze · tl at gocept.com
gocept gmbh & co. kg · forsterstraße 29 · 06112 halle (saale) · germany
http://gocept.com · tel +49 345 1229889 0 · fax +49 345 1229889 1
Zope and Plone consulting and development
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://mail.zope.org/pipermail/grok-dev/attachments/20081013/c28df6be/attachment.bin