This website is built using Docusaurus 2, a modern static website generator.
This deploys through GitHub actions!
To use this site locally and see your doc rendered as website, just use the following commands.
npm install(only initially needed)npm start
This will install all dependencies necessary and run the website on http://localhost:3000/.
We do want to follow a specific style for our markdown based documentation. Therefore, this repository is configured to use a markdown linter. Specific rules are configured via .markdownlint.yaml.
Additionally, there is a npm script lint-doc, that will lint all the markdown files inside docs and lint-kits, that will lint all the markdown files inside docs-kits.
This script is also run as a pre-commit hook, set up via husky.
You can also run the linting step manually by running npm run lint-doc or npm run lint-kits.