Automatic checks

The starter pack comes with several automatic checks that you can (and should!) run on your documentation before committing and pushing changes.

The following checks are available:

• Accessibility check
• Inclusive language check
• Link check
• Spelling check
• Style guide linting

Install prerequisite software

Some of the tools used by the automatic checks might not be available by default on your system. To install them, you need snap and npm:

sudo apt install npm snapd

To install the validation tools:

make woke-install
make pa11y-install

Note

Both woke and pa11y are non-blocking checks in our current documentation workflow.

Default GitHub actions

The starter pack uses default workflows from the documentation-workflows repository.

The current defaults force usage of Canonical hosted runners, which some projects may not be able to use. You may select your own runners with an override, see line 7 below:

jobs:
documentation-checks:
   uses: canonical/documentation-workflows/.github/workflows/documentation-checks.yaml@main
   with:
      working-directory: "docs"
      fetch-depth: 0
      runs-on: "ubuntu-22.04"