[Zope-dev] Interfaces vs ZCA concepts

[Martijn Faassen]

Hey,

Tres Seaver wrote:
[let's not suddenly change the behavior of __call__ for backwards 
compatibility reasons]

> If so, that code is already broken:  it depends on an undocumented
> implementation detail (of a non-API method).  The patch makes the
> __call__ method an API, and documents the (new) exception type. Anybody
> whose code breaks when this happens can hold off upgrading
> zope.interface until they fix that usage.

Documentation status aside, are you really maintaining that a feature 
that people have been using for many years is not actually part of the 
API? So that we can change willy-nilly without any concern for backwards 
compatibility?

If you do insist on taking that position, then please note that while 
API may not be documented in zope.interface it is certainly documented 
in other places. The __call__ behavior and the TypeError behavior for 
instance is documented in at least one published book (see bottom of the 
page):

http://docs.zope.org/zope3/Book/ifaceschema/interface/show.html

Documented for years.

[snip part where changing the name of a parameter is also fine as it's 
undocumented]

-1 against merging this.

Regards,

Martijn