When an API consumer signs in to the Choreo Developer Portal to browse APIs, it is not sufficient to just have an API thumbnail along with the name and version of the API. An API consumer would expect to see more details about the API, such as the following:
- A brief description of the API.
- How to invoke the API.
- The limitations/restrictions of the API.
- Version history.
To provide such information that improves the overall visibility of the API, an API developer can add such documentation to an API before publishing it to the Developer Portal.
Add documents to an API¶
To add documentation for an API, follow the steps given below.
Sign in to the Choreo Console.
In the Component Listing pane, click on the component for which you want to add documents.
In the left navigation menu, click Manage and then click Documents.
Specify a title for the document and provide the content in markdown syntax.
Click Add to save the document.
Depending on the information you need to add to the API, you can add one or more documents.
You can also edit existing documents and delete documents if necessary.