Tag
api-versioning
- May 3, 2025 Expand, Migrate, Contract: Changing an Interface Without a Flag Day When callers cannot be changed in one deploy, the change is split into three phases that are each independently safe: add the new shape, move every user, remove the old. software engineering
- Sep 20, 2024 Versioning the Platform Interface Under Existing Tenants How a self-service interface changes without breaking its consumers: explicit versions, compatibility guarantees, and why the parts nobody uses break first. devops
- Jul 5, 2024 Deprecation Windows and the Machinery Behind Compatibility Shims How an old interface is kept working while its replacement is adopted, what a shim must translate, and how to decide when removal is safe rather than merely scheduled. devops
- Apr 10, 2023 Compatibility Promises as Borrowed Time Publishing a contract converts a one-time edit into an open-ended obligation. Which changes are actually breaking, and how client tolerance determines what a server may do. software architecture