How should Stripe deprecate APIs? (~2016)

While Stripe is a widely admired company for things like itscreation of the Sorbet typer project, I personallythink that Stripe’s most interesting strategy work is also among its most subtle:its willingness to significantly prioritize API stability.

This strategy is almost invisible externally.Internally, discussions around it were frequent and detailed, but mostly confined to dedicated API design conversations.API stability isn’t just a technical design quirk, it’s a foundational decision ...