[Zope3-dev] Re: APIs breakage

[Jim Fulton]

Garrett Smith wrote:
> Stephan Richter wrote:
> 
>> On Tuesday 13 July 2004 11:12, Garrett Smith wrote:
>>
>>> But seeing a low level utility function, not named with underscore, used
>>> outside its module in several places would strongly hint at public
>>> intent.
>>
>>
>>
>> It was used in one outside place, which was very much related to the 
>> original intend.
> 
> 
> My mistake then. But it's going to be hard to *not* reuse functions like 
> that just because they're not defined in an interface. I suppose then 
> these names are subject to change without notice. User beware, I guess.

Yes, *but* we need to do a better job of documenting what's public
and being careful about what we decide to be public.

For example, if we follow my earlier proposal, we really ought to
go through the various interfaces.py files and weed out the apis that
we're not willing to commit to.

Jim


-- 
Jim Fulton           mailto:jim at zope.com       Python Powered!
CTO                  (540) 361-1714            http://www.python.org
Zope Corporation     http://www.zope.com       http://www.zope.org