All docs are found in the /docs
directory.
Uses standard CommonMark markdown spec formatting, with default VuePress Markdown Extensions.
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.
Run
npm ci
to quickly install all necessary dependencies. You can then runnpm run docs:dev
to 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 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:
- Spell checker auto-lint in Markdown files
- Automatic code formatting via
prettier
on file save
Deployment is handled automatically via Netlify CI. ๐
Search is handled via Algolia DocSearch, configuration changes must be made via PR to the config file (format documentation). Index is updated once every 24 hrs.