Merge pull request #3329 from rhcarvalho/python-workflow

Python workflow

.pylintrc

@@ -18,7 +18,8 @@ persistent=no
 load-plugins=
 
 # Use multiple processes to speed up Pylint.
-jobs=1
+# Zero means use the total number of CPUs.
+jobs=0
 
 # Allow loading of arbitrary C extensions. Extensions are imported into the
 # active Python interpreter and may run arbitrary code.

CONTRIBUTING.md

@@ -85,6 +85,24 @@ parallel
 pip install tox detox
 ```
 
+---
+
+Note: before running `tox` or `detox`, ensure that the only virtualenvs within
+the repository root are the ones managed by `tox`, those in a `.tox`
+subdirectory.
+
+Use this command to list paths that are likely part of a virtualenv not managed
+by `tox`:
+
+```
+$ find . -path '*/bin/python' | grep -vF .tox
+```
+
+Extraneous virtualenvs cause tools such as `pylint` to take a very long time
+going through files that are part of the virtualenv.
+
+---
+
 List the test environments available:
 ```
 tox -l