Automatically check for typos using codespell + pre-commit

[pradyunsg]

It could be worthwhile to look into whether a pre-commit hook spell-checking some files would be more helpful than not.

Originally posted by @chrahunt in #7642 (comment)

---

Looks like https://github.com/codespell-project/codespell has a pre-commit hook configuration. The configuration change would be to add the following to our .pre-commit-config.yaml file.

- repo: https://github.com/codespell-project/codespell
  rev: v1.16.0
  hooks:
    - id: codespell

[chrahunt]

Some targets for this check would be:

1. docs
2. news files
3. README
4. code comments

What needs investigation is how often we'll get false positives and what the remediation is, but the best way to do that is to add it to the list of checks and submit a PR.

[webknjaz]

Bonus points for integrating sphinx-spellcheck too.

[aphedges]

There is some more recent discussion about Codespell in #10569.

[webknjaz]

There is some more recent discussion about Codespell in #10569.

I guess, that'll do. Though per my testing, it's not as good with markup like rst for some reason.