12.1The Problem

API documentation says one thing, the implementation does another. This is schema drift -- one of the most common sources of integration bugs. A field gets renamed, an enum gains a value, a nullable field becomes required, and downstream consumers break silently because the documentation (and therefore the consumer tests) are stale.