An API Commons schema for publishing a provider’s deprecation policy layer as machine-readable data. Minimum notice, support window per version, announcement channels, and use of the Deprecation (RFC 9745) and Sunset (RFC 8594) headers, as data.
API Commons Deprecation Policy
The API Commons Deprecation Policy schema is one of eight business layers that make the political side of an API machine-readable, beside the technical contract. Minimum notice, support window per version, announcement channels, and use of the Deprecation (RFC 9745) and Sunset (RFC 8594) headers, as data.
It profiles existing work rather than inventing: see RFC 9745 and RFC 8594. Generated documents for catalog providers are stamped with x-apis-io-derivation and live in each provider’s repository; the schema, under Apache 2.0, is at github.com/api-commons/deprecation-policy.
Background: The Technical Side Translated. The Business Side Did Not.
Industry: api-specification