3 Areas to Cover while doing API Documentation
- Landing page which provides details such as high level information of APIs, links to APIs pages, release information, changelog details
- A summary page providing an overview on APIs in general, list of API names and one liner for each of the APIs
- One page each for each of the APIs where following details could be included:
- API Description providing details on some of the following:
- Functional details including information on what API accomplishes
- API syntax including method signature and request, response parameters
- Request and response parameters such as parameters’ description, data type, mandatory or optional information
- Exception details including error codes, what do they mean and how to handle them.
- One or more code examples which could be used by developers when integrating with APIs
- Related APIs which are used along with this API or which provide greater details in relation with functioning of the API
- References, if any, to get further details about APIs
- API Description providing details on some of the following:
- Bayesian thinking & Real-life Examples - February 2, 2023
- True Error vs Sample Error: Difference - January 30, 2023
- Confidence Intervals Formula, Examples - January 29, 2023
Leave a Reply