[Zope-dev] deprecating the deprecation system?

[Hanno Schlichting]

Martijn Faassen wrote:
> The deprecation system is a system that is intended to help developers 
> upgrade their code and that allows us to remove certain deprecated 
> features after a while.
> 
> * we have quite a few of these developers who are not happy about the 
> deprecation system.
> 
> * we've been bad at removing deprecated features after a while.
> 
> So I will conclude that from the community perspective the system hasn't 
> really done its job as well as it should.

The system certainly hasn't worked as well as we had hoped. Nonetheless
issuing deprecation warnings is not an invention of Zope but Python does
this itself. The deprecation warnings you get from Python are most of
the times not more than: "X is gonna go away, use Y instead".

But you will then go to the upgrade guide or documentation section of
the new Python version and look at the new features. Having the focus
more on human readable documentation is certainly a good idea.

Hanno