All docs are found in the
If you wish to be able to see changes reflected live, you can run a local dev server. Requires a NodeJS environment on your machine.
npm cito quickly install all necessary dependencies. You can then run
npm run docs:devto launch a local live-reload instance of the docs. Changes will be reflected as soon as you save the source file.
You can also run
npm run docs:build if you ever want to manually build the
static output. This is normally handled on the CI server automatically. For
consistent code formatting we use Prettier, if you wish you can format all
files prior to a commit via
npm run format.
vscode Workspace Settings
VSCode workspace settings are included in this repository, when opening for the first time you should be prompted to install some recommended extensions. Once installed, you should automatically get:
- Syntax highlighting and snippets for "stylus" files
- Automatic code formatting via
prettieron file save
Please make sure that if you add new image files, it's done via a Pull Request. Images will then be automatically optimized for filesize in CI! :-)
Deployment is handled automatically via Netlify.
The written documentation and source code examples are licensed under the Creative Commons Attribution 4.0 International license.