A formal vocabulary of words and phrases that can and cannot be used across operations.
Governance Vocabulary
Rules
APIs.json Apis Properties Vocabulary Info
This property so that there is a centralized vocabulary in use for guiding the creation and usage of tags, path segments, and other metadata associated with an APIs
Strategies
APIs Must Be Actively Governed
Governance is what keeps things from turning into chaos, but it only works when it is active and ongoing. Not a document someone wrote two years ago. You need a common lifecycle, policies and rules...
API Maturity Is Measured and Improved
You can't improve what you don't measure, and that applies to APIs as much as anything else. A maturity model that scores documentation, security, testing, monitoring, and consumer experience gives...