View on GitHub


Documentation for check-spelling

Configuration: Multiple programming languages


Projects often contain code written in multiple programming languages or even documentation written in multiple human languages.

The simplest approach is to just run the spell-checker over the whole system and add items to the dictionary/exceptions regardless of their origin.

It might be the case that one actually has differing word choice rules depending on the language.

It is possible to enforce this today using a single workflow file.

One can also use this when spell checking takes too long (in general, anything over 15 minutes is probably too long).

Working approach

(as of 0.0.19)

To define multiple sets, one can:


name: Spell checking

    runs-on: ubuntu-latest
      fail-fast: false
        category: ["java", "python", "other"]
    name: Spell checking (${{matrix.category}})
    - name: checkout-merge
      if: "contains(github.event_name, 'pull_request')"
      uses: actions/checkout@v2
        ref: refs/pull/${{github.event.pull_request.number}}/merge
    - name: checkout
      if: "!contains(github.event_name, 'pull_request')"
      uses: actions/checkout@v2
    - uses: check-spelling/check-spelling@prerelease
      id: spelling
        config: .github/actions/spelling-${{matrix.category}}
        report_title_suffix: ${{matrix.category}}


You will get distinct reports (i.e. potentially multiple comments) for spelling errors from different kinds of files.

I think, generally, a developer is only writing changes in one language at a time.

Also, there's a limit that I've hit where if there are more than ~10 (?) items to report, the rest aren't tagged. I suspect that this would mean each category would get its own 10 😃 .

See also

Using Area dictionaries should make this pretty reasonable (you could specify distinct area dictionaries using the matrix, but, you the cost for the extra dictionaries is minimal, so I'd just include all of them unconditionally).

FAQ | Showcase | Event descriptions | Configuration information | Known Issues | Possible features | Deprecations | Release notes | Helpful scripts