Overview
Explore strategies for minimizing API breaking changes in this 28-minute RubyConf 2021 talk by Lisa Karlin Curtis. Learn to identify potential breaking changes, help API consumers build resilient integrations, and safely release updates. Discover techniques for documenting edge cases, effective naming practices, and the importance of semantic versioning. Gain insights on overcommunication and mitigation strategies to maintain smooth API interactions and prevent unexpected live-ops incidents.
Syllabus
Introduction
A sad story
Examples
Definition
Assumptions
Observer behaviour
MSDOS example
Assumptions are unconscious
Document edge cases
Naming
A change isnt breaking
Not all breaking changes are equal
Identifying which integrators to reach out to
Semantic versioning
Overcommunicating
Mitigation
Conclusion
Taught by
Ruby Central