Add a more self-contained pre-commit hook

.pre-commit-hooks.yaml

@@ -3,3 +3,10 @@
   entry: scripts/pre-commit.sh
   language: 'script'
   description: "Runs `woke`"
+- id: woke-from-source
+  name: 'woke'
+  entry: woke
+  args: [--exit-1-on-failure]
+  # The 'go' binary on your path must be at least version 1.17.
+  language: 'golang'
+  description: "Runs `woke`, building it from source on demand"

docs/tools.md

@@ -4,3 +4,40 @@
 - [GitHub Action (reviewdog)](https://github.com/marketplace/actions/run-woke-with-reviewdog)
 - [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=get-woke.vscode-woke)
 - [VIM Plugin](https://github.com/get-woke/vim-woke)
+
+## Pre-commit hook
+
+`woke` supports being run from a [pre-commit](https://pre-commit.com/) hook,
+allowing you to avoid accidentally committing uses of non-inclusive
+language.
+You have two alternative mechanisms for doing so.
+If you have arranged to install `woke` on your command search path (as well
+as anyone working on your repository), then add this configuration to your
+`.pre-commit-config.yaml`:
+
+```yaml
+-   repo: https://github.com/get-woke/woke
+    rev: ''  # pick a tag to point to
+    hooks:
+    -   woke
+```
+
+(Note that in this case the `rev` only controls the version of a wrapper
+script that is used, not the version of `woke` itself.)
+
+Alternatively, you can tell `pre-commit` to build `woke` from source,
+although this requires you and anyone working on your repository to have
+`go` on your command search path and for it to be at least version 1.17:
+
+```yaml
+-   repo: https://github.com/get-woke/woke
+    rev: ''  # pick a tag to point to
+    hooks:
+    -   woke-from-source
+```
+
+(In this case the `rev` controls the version of `woke` itself.)
+
+See the [pre-commit
+documentation](https://pre-commit.com/#pre-commit-configyaml---hooks) for
+how to customize this further.