kytrinyx · Nov 25, 2015
diff --git a/docs/HELLO.md b/docs/HELLO.md
diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md
@@ -2,9 +2,18 @@ If Python isn't already available on your system follow the instructions at [the
 
 Exercism currently supports Python3.4, Python3.3 and Python2.7.
 
-
 ## Packages
 
 The [Python Package Index](https://pypi.python.org/pypi) contains thousands of packages.
 Pretty much each of them is installable with `pip install packagename`.
 If you don't have __pip__ already, [get it now](https://pip.pypa.io/en/latest/installing.html)!
+
+##  Tests
+
+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.
+
+### Installation
+
+```bash
+$ pip install pytest pytest-cache
+```
diff --git a/docs/LEARNING.md b/docs/LEARNING.md
@@ -0,0 +1,4 @@
+* [The Python Tutorial](https://docs.python.org/3/tutorial/)
+* [Learn Python The Hard Way](http://learnpythonthehardway.org/book/)
+* [Think Python](http://www.greenteapress.com/thinkpython/html/index.html)
+* [The Python Library Reference](https://docs.python.org/3/library/index.html)
diff --git a/docs/RESOURCES.md b/docs/RESOURCES.md
@@ -1,6 +1,71 @@
-## Recommended learning resources
+####PDB
 
-* [The Python Tutorial](https://docs.python.org/3/tutorial/)
-* [Learn Python The Hard Way](http://learnpythonthehardway.org/book/)
-* [Think Python](http://www.greenteapress.com/thinkpython/html/index.html)
-* [The Python Library Reference](https://docs.python.org/3/library/index.html)
+Will drop you into the python debugger when a test fails.
+To learn how to use pdb, check out the [documentation](https://docs.python.org/2/library/pdb.html#debugger-commands).
+
+You may also be interested in watching [Clayton Parker's "So you think you can pdb?" PyCon 2015 talk](https://www.youtube.com/watch?v=P0pIW5tJrRM)
+
+```bash
+$ cd exercism/python/bob
+$ py.test --pdb bob_test.py
+```
+
+####PEP8
+
+PEP8 is the [python style guide](https://www.python.org/dev/peps/pep-0008/). If you would like to test for compliance to the style guide, install [pytest-pep8](https://pypi.python.org/pypi/pytest-pep8)
+
+```bash
+$ pip install pytest-pep8
+```
+
+and add the pep8 flag to your command
+
+```bash
+$ cd exercism/python/bob
+$ py.test --pep8 bob_test.py
+```
+
+Read the [pytest documentation](http://pytest.org/latest/contents.html#toc) and [pytest-cache](http://pythonhosted.org/pytest-cache/) documentation to learn more.
+
+## Visual Studio on Windows
+
+Follow the installation instructions for [Python Tools for Visual Studio](https://pytools.codeplex.com/wikipage?title=PTVS%20Installation)
+
+You can either start by creating your own project for working with the Exercism problems or you can download a Visual Studio solution that is already set up.
+
+### Exercism.io Visual Studio Template
+
+This is a Visual Studio template that comes pre-configured to work on the problems in as many languages as Visual Studio supports.
+
+![Solution Explorer](http://x.exercism.io/v3/tracks/python/docs/img/SolutionExplorer.png)
+
+1. Download the [Exercism.io Visual Studio Template](https://github.com/rprouse/Exercism.VisualStudio) from GitHub by clicking the Download Zip button on the page.
+2. Unzip the template into your exercises directory, for example `C:\src\exercises`
+2. Install the [Exercism CLI](http://help.exercism.io/installing-the-cli.html)
+3. Open a command prompt to your exercise directory
+4. Add your API key to exercism `exercism configure --key=YOUR_API_KEY`
+5. Configure your source directory in exercism `exercism configure --dir=C:\src\exercises`
+6. [Fetch your first exercise](http://help.exercism.io/fetching-exercises.html) `exercism fetch python`
+7. Open the Exercism solution in Visual Studio
+8. Expand the Exercism.python project
+9. Click on **Show All Files** in Solution Explorer (See below)
+10. The exercise you just fetched will appear greyed out. Right click on the folder and **Include In Project**
+11. Get coding...
+
+![Add files](http://x.exercism.io/v3/tracks/python/docs/img/AddFiles.png)
+
+To run the tests, you can do so at the command line, or within Visual Studio.
+
+![Test Explorer](http://x.exercism.io/v3/tracks/python/docs/img/TestExplorer.png)
+
+## Code Style and Linting
+
+There's a style guide called [PEP8](http://legacy.python.org/dev/peps/pep-0008/) that many Python projects adhere to.
+Read it when you get a chance!
+
+If you just want a quick overview of some problems in your code, use [pylint](http://www.pylint.org/)!
+It can be pretty picky though, so take its results with a grain of salt.
+If you don't agree with one of its points, that's a good topic for a discussion in the comments for your program!
+
+If you'd rather have a tool take care of your style issues, take a look at [autopep8](https://github.com/hhatto/autopep8)!
+Run `autopep8 -d mycode.py` to get a diff of the changes it proposes and `autopep8 -i mycode.py` to format the code inplace!
diff --git a/docs/TESTS.md b/docs/TESTS.md
@@ -0,0 +1,47 @@
+If you choose not to install pytest, you can still run tests individually:
+
+```bash
+$ cd exercism/python/bob
+$ python bob_test.py
+```
+
+##  Pytest Examples
+
+####Run All Tests
+
+```bash
+$ cd exercism/python/bob
+$ py.test bob_test.py
+```
+
+####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
+```
diff --git a/docs/TOOLS.md b/docs/TOOLS.md
diff --git a/docs/WORKFLOW.md b/docs/WORKFLOW.md