OpenAPI 'deprecated' flag produces no actionable signal for consumers
Our API contract is defined in OpenAPI 3.0.x, and we mark sunset operations with the standard deprecated: true property on the operation object. The flag renders correctly in Swagger UI (strikethrough styling), but that is where the signal ends: consumers only notice the deprecation if they happen to open the docs. The goal is to turn this documented, machin