Providing a robust description of the API contract, as well as each API it contains, providing my context for stakeholders of the contract.
Descriptions for APIs.json Contracts
Rules
APIs.json Description Info
Every collection of APIs defined in APIs.json needs to include a one- or two-paragraph description outlining the purpose of the APIs. While individual APIs needs their own descriptions, the collect...
Strategies
APIs are Defined as API Contracts
I think of API contracts as the thing that bridges the business and technology sides of what we do. When you define APIs as contracts and manage them in source control, you can track not just the t...