DNSimple API Documentation
This is the DNSimple API documentation.
These are the most important folders and files to keep in mind while working on this repo:
content: this folder contains the markdown files that generate the site
content/v2/openapi.yml: the API definition described using the OpenAPI specification (see below)
examples: this folder contains the API response fixtures generated from real API calls you can use to test your integrations
The OpenAPI description is the main source of truth, and must be kept up to date with the other changes in the site. At the time being, the site and the OpenAPI must be kept in sync manually. That means any change in the markdown documentation files needs to be reflected in the OpenAPI file.
The markdown documentation is a subset of the OpenAPI description. There may be information that - for the sake of brevity - are omitted in the markdown files, and sometimes delegated to the OpenAPI description.