UiTdatabank API documentation. Useful for including JSON schemas in your application to work with.
This is the repository behind https://publiq.stoplight.io/docs/uitdatabank
- Create a branch with your changes
- Create a PR for your branch
- Fix any problems detected by the automatic checks
- Merge once someone has reviewed and approved your changes
Be sure to also check the internal guidelines on how to design APIs and write documentation. (Login required)
Never update the following files manually, but use cultuurnet/stoplight-ci instead!
If you update them manually, your changes will get overwritten in later updates to the CI setup.
The automatic checks will be run via GitHub actions for every commit pushed to every branch.
Some examples of automatic checks are dead links in the docs, malformed Markdown in the docs, or invalid JSON in the OpenAPI file(s).
To install or update the required packages to run the checks, run
yarn docs:lint to check for errors or warnings. If any errors or warnings are detected, you can either fix them manually or try to fix them with
yarn api:lint to check for errors or warnings. If any errors or warnings are detected, you need to fix them manually for now.