API documentation represents any description of the functionality of the API. Since this documentation will be used by external developers, we need to follow some best practices. They are :
* Plan what needs to be shown in your documentation.
* Do not exclude any fundamental sections of the API functionality.
* Use simple words by avoiding technical jargon.
* Include various interactive examples and resources to understand the API functionality clearly.
* Consistently maintain the documentation as and when the functionality gets updated.
Some of the popular tools used for achieving API documentation are :
* JavaDoc
* Doxygen
* OpenAPI
* Redoc
* Swagger UI