Add --extend-exclude parameter (#2005)

[etc/vim.git] / CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 525cb9c183d3979447a09145ff24736212d0e93e..571d870452bc4c6f36473d26026b5da83c915b95 100644 (file)
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -19,7 +19,7 @@ unlikely to get accepted. You can still try but prepare to be disappointed.
 
 ## Technicalities
 
 
 ## Technicalities
 

-Development on the latest version of Python is preferred. As of this writing it's 3.8.
+Development on the latest version of Python is preferred. As of this writing it's 3.9.

 You can use any operating system. I am using macOS myself and CentOS at work.
 
 Install all development dependencies using:
 You can use any operating system. I am using macOS myself and CentOS at work.
 
 Install all development dependencies using:


@@ -34,18 +34,44 @@ If you haven't used `pipenv` before but are comfortable with virtualenvs, just r
 `pip install pipenv` in the virtualenv you're already using and invoke the command above
 from the cloned _Black_ repo. It will do the correct thing.
 
 `pip install pipenv` in the virtualenv you're already using and invoke the command above
 from the cloned _Black_ repo. It will do the correct thing.
 

-Before submitting pull requests, run lints and tests with:
+Non pipenv install works too:

 
 ```console
 
 ```console

+$ pip install -r test_requirements
+$ pip install -e .[d]
+```
+
+Before submitting pull requests, run lints and tests with the following commands from
+the root of the black repo:
+
+```console
+# Linting

 $ pre-commit run -a
 $ pre-commit run -a

-$ python -m unittest
+
+# Unit tests
+$ tox -e py
+
+# Optional Fuzz testing
+$ tox -e fuzz
+
+# Optional CI run to test your changes on many popular python projects

 $ black-primer [-k -w /tmp/black_test_repos]
 ```
 
 $ black-primer [-k -w /tmp/black_test_repos]
 ```
 

+### Docs Testing
+
+If you make changes to docs, you can test they still build locally too.
+
+```console
+$ pip install -r docs/requirements.txt
+$ pip install [-e] .[d]
+$ sphinx-build -a -b html -W docs/ docs/_build/
+```
+

 ## black-primer
 
 `black-primer` is used by CI to pull down well-known _Black_ formatted projects and see
 ## black-primer
 
 `black-primer` is used by CI to pull down well-known _Black_ formatted projects and see

-if we get soure code changes. It will error on formatting changes or errors. Please run
+if we get source code changes. It will error on formatting changes or errors. Please run

 before pushing your PR to see if you get the actions you would expect from _Black_ with
 your PR. You may need to change
 [primer.json](https://github.com/psf/black/blob/master/src/black_primer/primer.json)
 before pushing your PR to see if you get the actions you would expect from _Black_ with
 your PR. You may need to change
 [primer.json](https://github.com/psf/black/blob/master/src/black_primer/primer.json)