WORKFLOW: Improved Documentation On Tests

Dog · Dog · commit 977e7db8a9de · 2015-06-19T22:52:42.000-07:00
* Recommended that users install pytest and pytest-cache
* Gave examples of how to use pytest
* Documented how to run tests without pytest
diff --git a/docs/WORKFLOW.md b/docs/WORKFLOW.md
@@ -1,22 +1,59 @@
-## Running Tests for an Exercise
+##  Tests
 
-Execute tests for an exercise with:
+We recommend you install [pytest](http://pytest.org/latest/) and [pytest-cache](http://pythonhosted.org/pytest-cache/). Pytest is a testing tool that will give you more flexibility over running your unit tests.
+
+If you choose not to install pytest, you can still run tests individually:
 
 ```bash
 $ cd exercism/python/bob
 $ python bob_test.py
 ```
 
-##  Running Tests for All Exercises
+### Installation
+
+```bash
+$ pip install pytest pytest-cache
+```
 
-Before running all the tests ensure you have pytest installed:
+##  Pytest Examples
+
+####Run All Tests
 
 ```bash
-$ pip install pytest
+$ cd exercism/python/bob
+$ py.test bob_test.py
 ```
-After pytest is installed all tests can be executed with:
+
+####Stop After First Failure
+
+```bash
+$ cd exercism/python/bob
+$ py.test -x bob_test.py
+```
+
+####Failed Tests First
+
+Pytest-cache remembers which tests failed, and can run those tests first.
+
+```bash
+$ cd exercism/python/bob
+$ py.test --ff bob_test.py
+```
+
+### Recommended
+
+We recommend you run this command while working on exercises.
+
+```bash
+$ cd exercism/python/bob
+$ py.test -x --ff bob_test.py
+```
+
+### Running All Tests for All Exercises
 
 ```bash
 $ cd exercism/python/
 $ py.test
 ```
+
+Read the [pytest documentation](http://pytest.org/latest/contents.html#toc) and [pytest-cache](http://pythonhosted.org/pytest-cache/) documentation to learn more.
