c4b5530e2e
* Add views count for authenticated users articles [#4250] * Bump API version to 0.5.6 [#4250] * Add info about bumping API docs version requirement * Fix Create pull request link by linking to the docs
1.1 KiB
1.1 KiB
| title |
|---|
| Contributing to API spec docs |
Contributing to API spec docs
The API docs follow the OpenAPI 3 specification.
Where The Docs Are Located
We auto-generate the documentation from api_v0.yml within the /docs directory.
We use ReDoc to turn the OpenAPI 3 format into a readable and searchable HTML documentation.
Updating API docs
Whenever you make changes to the API docs, make sure to bump the version in api_v0.yml.
Running and editing the Docs Locally
If you want to browse the documentation locally you can use:
yarn api-docs:serve
This will let you browse the auto-generated version of the doc locally, and it will reload the doc after every modification of the spec file.
If you have Visual Studio Code, we suggest you install the following extensions that enable validation and navigation within the spec file: