- fix a docs typo about `pull-requests` permissions
- add write permissions to token in self-test CI
- improve self-test CI step that shows `*checks-failed` outputs

* use `contents: write` permission to post comments on push events
* update docs

Bumps the pip group with 2 updates: [clang-tools](https://github.com/cpp-linter/clang-tools-pip) and [cpp-linter](https://github.com/cpp-linter/cpp-linter).


Updates `clang-tools` from 0.12.0 to 0.12.1
- [Release notes](https://github.com/cpp-linter/clang-tools-pip/releases)
- [Commits](cpp-linter/clang-tools-pip@v0.12.0...v0.12.1)

Updates `cpp-linter` from 1.7.4 to 1.8.1
- [Release notes](https://github.com/cpp-linter/cpp-linter/releases)
- [Commits](cpp-linter/cpp-linter@v1.7.4...v1.8.1)

---
updated-dependencies:
- dependency-name: clang-tools
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: pip
- dependency-name: cpp-linter
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: pip
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* feat: add --jobs parameter to action
  See cpp-linter/cpp-linter#92 for the related CLI updates.
* adjustments for docs
---------

Co-authored-by: Brendan <2bndy5@gmail.com>