wordsmith py.test and coverage configuration

1 files changed, 14 insertions, 6 deletions

diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index 8849e9ee7..a25394151 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -227,11 +227,7 @@ Here's sample output from a test run on UNIX:
 
 The tests themselves are found in the ``tests.py`` module in your ``pcreate``
 generated project.  Within a project generated by the ``starter`` scaffold,
-only two sample tests exist. Previous command is identical to:
-
-.. code-block:: bash
-
-   $ $VENV/bin/py.test myproject/tests.py -q
+only two sample tests exist.
 
 .. note::
 
@@ -244,7 +240,19 @@ to ``py.test``:
 
 .. code-block:: bash
 
-   $ $VENV/bin/py.test -q --cov
+   $ $VENV/bin/py.test --cov -q
+
+Scaffolds include configuration defaults for ``py.test`` and test coverage.
+These configuration files are ``pytest.ini`` and ``.coveragerc``, located at
+the root of your package. Without these defaults, we would need to specify the
+path to the module on which we want to run tests and coverage.
+
+.. code-block:: bash
+
+   $ $VENV/bin/py.test --cov=myproject myproject/tests.py -q
+
+.. seealso:: See py.test's documentation for :ref:`pytest:usage` or invoke
+   ``py.test -h`` to see its full set of options.
 
 
 .. index::