Each API included in an APIs.json file should have a 1-3 paragraph description. This description serves as the first impression for potential consumers and is often displayed in portals, networks, search results, and other discovery channels. A well-crafted description plays a key role in helping API consumers understand and onboard with the API effectively.
APIs.json APIs Description Info
Message: Has a Description
Policies
Descriptions for APIs
Providing a robust description of each API, providing the right amount of information for consumers to understand what is possible and what the business use case is.