In August, I wrote to this list to discuss the when and how breaking changes can be made without deprecation. The proposal I made at the time was admittedly rather radical, but it lead of a good discussion and flushed out a number of pain points and interesting ideas. Based on this discussion and other feedback, I have drafted an update to the Stable Interface Policy. You can find it here:
The draft has entered the RFC
process, and I intended to move it through swiftly, so it
can be adopted soon. If you have any thoughts or feedback, please
reply to this email, or put it on the phab task.
I would like to highlight a few of the changes that I am proposing:
The intent is to streamline the deprecation process, ensuring
that deprecated code becomes unused quickly, without causing too
much of a disturbance.
Besides this, the proposal contains a number of other additions and clarifications, as described on the phab ticket and visible in the diff.
I'm looking forward to hearing your thoughts and ideas!
Daniel Kinzler Principal Software Engineer, Core Platform Wikimedia Foundation