Improve docs about pre-commit and mypy

.pre-commit-config.yaml

@@ -51,13 +51,13 @@ repos:
  "types-tabulate",
  "types-urllib3",
  ]
- # Unfortunately, `pre-commit` only runs on changed files
+ # Unfortunately, `pre-commit` only runs on modified files
  # This doesn't work well with `mypy --follow-imports error`
  # See: https://github.com/pre-commit/mirrors-mypy/issues/34#issuecomment-1062160321
  #
  # To work around this we run `mypy` only in manual mode
- # So it won't run as part of `git commit` command
- # But it will still be run as part of `pre-commit` workflow and give expected results
+ # So it won't run as part of `git commit` command,
+ # but it will still be run as part of `pre-commit` workflow and give expected results
  stages: [manual]
 
  # Autoformat: YAML, JSON, Markdown, etc.

docs/contributing/lint.md

@@ -38,7 +38,7 @@ pre-commit run --all-files --hook-stage manual
 ```
 
 ```{note}
-We're running `pre-commit` with `--hook-stage manual`, because works with changed files, which doesn't work well for mypy.
+We're running `pre-commit` with `--hook-stage manual`, because `pre-commit` is run on modified files only, which doesn't work well with `mypy --follow-imports error`.
 More information can be found in [`.pre-commit-config.yaml` file](https://github.com/jupyter/docker-stacks/blob/main/.pre-commit-config.yaml)
 ```