Bump minimum_pre_commit_version per recommendation (#1895)

[etc/vim.git] / docs / version_control_integration.md

diff --git a/docs/version_control_integration.md b/docs/version_control_integration.md
deleted file mode 120000 (symlink)
index 8de4b67b9a80350aca04e355edc89c73c26a7b30..0000000000000000000000000000000000000000
--- a/docs/version_control_integration.md
+++ /dev/null
@@ -1 +0,0 @@
-_build/generated/version_control_integration.md
\ No newline at end of file

diff --git a/docs/version_control_integration.md b/docs/version_control_integration.md
new file mode 100644 (file)
index 0000000000000000000000000000000000000000..0e09854a2e5e1a8f194e508b6dd18c96630203fb
--- /dev/null
+++ b/docs/version_control_integration.md
@@ -0,0 +1,33 @@
+[//]: # "NOTE: THIS FILE WAS AUTOGENERATED FROM README.md"
+
+# Version control integration
+
+Use [pre-commit](https://pre-commit.com/). Once you
+[have it installed](https://pre-commit.com/#install), add this to the
+`.pre-commit-config.yaml` in your repository:
+
+```yaml
+repos:
+  - repo: https://github.com/psf/black
+    rev: 20.8b1 # Replace by any tag/version: https://github.com/psf/black/tags
+    hooks:
+      - id: black
+        language_version: python3 # Should be a command that runs python3.6+
+```
+
+Then run `pre-commit install` and you're ready to go.
+
+Avoid using `args` in the hook. Instead, store necessary configuration in
+`pyproject.toml` so that editors and command-line usage of Black all behave consistently
+for your project. See _Black_'s own
+[pyproject.toml](https://github.com/psf/black/blob/master/pyproject.toml) for an
+example.
+
+When using the `--diff` flag with `pre-commit`, you must also use the `--check` flag.
+When you want to run _Black_ only on specific files in pre-commit, either use
+pre-commit's own `files` and `exclude` or, when using _Black_'s `--include`, set
+`--force-exclude` to the negated regex of `--include`.
+
+If you're already using Python 3.7, switch the `language_version` accordingly. Finally,
+`stable` is a branch that tracks the latest release on PyPI. If you'd rather run on
+master, this is also an option.