Hi all!

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:

User:DKinzler_(WMF)/Stable_interface_policy (diff)

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