Merge pull request Pylons#470 from miketheman/miketheman/contributing

docs,tests: update contributing running tests section

Author: digitalresistor

.coveragerc

@@ -11,3 +11,6 @@ source =
 [report]
 show_missing = true
 precision = 2
+
+[html]
+show_contexts = True

contributing.md

@@ -36,20 +36,42 @@ one or two development branches are actively maintained.
 Running Tests
 -------------
 
-*Note:* This section needs better instructions.
-
 Run `tox` from within your checkout. This will run the tests across all
 supported systems and attempt to build the docs.
 
-To run the tests for Python 2.x only:
+For example, to run the test suite with your current Python runtime:
+
+```shell
+tox -e py
+```
+
+If you wish to run multiple targets, you can do so by separating them with a
+comma:
+
+```shell
+tox -e py312,coverage
+```
+
+If you've already run the coverage target and want to see the results in HTML,
+you can override `tox.ini` settings with the `commands` option:
+
+```shell
+tox -e coverage -x testenv:coverage.commands="coverage html"
+```
+
+To build the docs:
 
-    $ tox py2-cover
+```shell
+tox -e docs
+```
 
-To build the docs for Python 3.x only:
+List all possible targets:
 
-    $ tox py3-docs
+```shell
+tox list # or `tox l`
+```
 
-See the `tox.ini` file for details.
+See `tox.ini` file for details, or <https://tox.wiki/> for general `tox` usage.
 
 
 Building documentation for a Pylons Project project

setup.cfg

@@ -8,4 +8,4 @@ license_file = docs/license.txt
 python_files = test_*.py
 testpaths =
     tests
-addopts = -W always --cov --cov-report=term-missing
+addopts = -W always --cov --cov-context=test --cov-report=term-missing