Correct path within sphinx config

Also update testing docs to show spec output.

docs/source/conf.py

@@ -15,12 +15,17 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #sys.path.insert(0, os.path.abspath('.'))
-import sys, os
-oscar_folder = os.path.realpath(os.path.join(os.path.dirname(__file__), '../..'))
+import sys
+import os
+oscar_folder = os.path.realpath(
+    os.path.join(os.path.dirname(__file__), '../..'))
+sandbox_folder = os.path.realpath(
+    os.path.join(os.path.dirname(__file__), '../../sites/sandbox'))
 sys.path.append(oscar_folder)
+sys.path.append(sandbox_folder)
 
 # Get django settings
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'sandbox.settings')
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'settings')
 
 # -- General configuration -----------------------------------------------------
 

docs/source/contributing.rst

@@ -30,10 +30,10 @@ Running tests
 
 Oscar uses a nose_ testrunner which can be invoked using::
 
-.. _nose: http://nose.readthedocs.org/en/latest/
-
     ./runtests.py
 
+.. _nose: http://nose.readthedocs.org/en/latest/
+
 To run a subset of tests, you can use filesystem or module paths.  These two
 commands will run the same set of tests::
 
@@ -54,7 +54,31 @@ To run an individual test, use one of::
 
 Oscar's testrunner uses the progressive_ plugin when running all tests, but uses
 the spec_ plugin when running a subset.  It is a good practice to name your test
-cases and methods so that the spec output reads correctly.
+cases and methods so that the spec output reads correctly.  For example::
+
+    $ ./runtests.py tests/unit/offer/benefit_tests.py:TestAbsoluteDiscount
+    nosetests --verbosity 1 tests/unit/offer/benefit_tests.py:TestAbsoluteDiscount -s -x --with-spec
+    Creating test database for alias 'default'...
+
+    Absolute discount
+    - consumes all lines for multi item basket cheaper than threshold
+    - consumes all products for heterogeneous basket
+    - consumes correct quantity for multi item basket more expensive than threshold
+    - correctly discounts line
+    - discount is applied to lines
+    - gives correct discount for multi item basket cheaper than threshold
+    - gives correct discount for multi item basket more expensive than threshold
+    - gives correct discount for multi item basket with max affected items set
+    - gives correct discount for single item basket cheaper than threshold
+    - gives correct discount for single item basket equal to threshold
+    - gives correct discount for single item basket more expensive than threshold
+    - gives correct discounts when applied multiple times
+    - gives correct discounts when applied multiple times with condition
+    - gives no discount for a non discountable product
+    - gives no discount for an empty basket
+
+    ----------------------------------------------------------------------
+    Ran 15 tests in 0.295s
 
 .. _progressive: http://pypi.python.org/pypi/nose-progressive/
 .. _spec: http://darcs.idyll.org/~t/projects/pinocchio/doc/#spec-generate-test-description-from-test-class-method-names