How Shopify Manages API Versioning and Breaking Changes - Shopify
Dec 17, 2019

Summary
This post details Shopify's API versioning strategy, which releases new date-based API versions quarterly. It explains the distinction between breaking and non-breaking changes, the process for analyzing the impact of breaking changes using `mark_breaking` and `mark_possibly_breaking` methods, and how `ApiChange.in_effect?` is used to manage the rollout of changes. The analogy of retraining police dogs highlights the significant effort required for system-wide changes.