Andrew Milton wrote at 2009-4-11 21:46 +1000:
... So your position is, the code is fine, but, the docs suck so don't use it. Well the docs have always sucked, the zope-3 docs don't seem any better. Perhaps the people deprecating and removing interfaces willy-nilly should document the replacements and how to change over existing consumers of the removed interfaces, or re-implement the removed interfaces using "the new way."
These are all issues for The Zope Foundation to address, not for you to badger individuals who don't agree with your dogma-de-jour. Badger the people responsible to do something.
The people driving the Zope Foundation are (mostly) unfortunately heavily in favour of what they call "cleaning up code" and removing backward compatibility.... -- Dieter