if there is a need to extend the API documentation beyond the OpenAPI specification, this is an indication that the API is too large and/or too complex
- Be sure to document differences between versions of the API
- Include documentation on any consumption constraints such as availability, authorization and rate limiting