doc updates

Author: machow

docs/source/Home.md

@@ -1,10 +1,8 @@
-Home
-====
+Background
+==========
 
-At DataCamp we build tools to [learn data science](https://www.datacamp.com) interactively. See e.g. our online [R tutorial](https://www.datacamp.com/courses/free-introduction-to-r) to learn R Programming and our Python For Data Science tutorial to [learn Python](https://www.datacamp.com/courses/intro-to-python-for-data-science).
-
-pythonwhat?
------------
+What is pythonwhat?
+-------------------
 
 A major part of DataCamp's interactive learning is centered around automated and meaningful feedback. When a student submits an incorrect answer, the system tells the student what he or she is doing wrong. This happens through so-called submission correctness tests, or SCTs. An SCT is a test script that compares the different steps in a student's submission to the ideal solution, and generates meaningful feedback along the way.
 

docs/source/index.rst

@@ -1,26 +1,38 @@
 pythonwhat
 ================================================
 
-Contents:
----------
+At DataCamp we build tools to `learn data science <https://www.datacamp.com>`_ interactively.
+See e.g. our online `R tutorial <https://www.datacamp.com/courses/free-introduction-to-r>`_ to learn R Programming and our Python For Data Science tutorial to `learn Python <https://www.datacamp.com/courses/intro-to-python-for-data-science>`_.
+
+To jump in to pythonwhat, check out the `Interactive Examples <https://datacamp.github.io/courses-pythonwhat-tutorial>`_ and the :doc:`Quickstart Guide <quickstart_guide>`.
+
 
 .. toctree::
+   :hidden:
    :maxdepth: 2
+   :caption: General
 
    Home
    quickstart_guide
+   interactive_examples
+   
+
+.. toctree::
+   :hidden:
+   :maxdepth: 2
+   :caption: API
+
    simple_tests/index.rst
    part_checks
    expression_tests
    logic_tests/index.rst
-   spec2_summary
 
 
-Pythonwhat V1
--------------
-
 .. toctree::
+   :hidden:
+   :caption: Upgrading from v1
 
+   spec2_summary
    pythonwhat.wiki/index.rst
 
 

docs/source/interactive_examples.rst

@@ -0,0 +1,8 @@
+Interactive Examples
+====================
+
+Click `here <https://datacamp.github.io/courses-pythonwhat-tutorial>`_ for walkthrough
+made up of interactive exercises.
+
+In order to raise issues or make changes to the walkthrough, see the
+`courses-pythonwhat-tutorial <https://github.com/datacamp/courses-pythonwhat-tutorial>`_ github repo.

docs/source/logic_tests/index.rst

@@ -1,9 +1,13 @@
 Logic Tests
 ===========
 
+These tests are used to combine different SCTs. For example, ``test_or`` takes
+one or more SCTs, and fails only if all of those SCTs fail.
+
 .. toctree::
    :maxdepth: 2
+   :hidden:
 
    test_correct
    test_or
-   test_no
+   test_not

docs/source/simple_tests/index.rst

@@ -2,11 +2,12 @@ Simple Tests
 ============
 
 Simple tests are the most basic tests available in pythonwhat. 
-They usually don't focus on specific pieces of a submission (:doc:`like part checks </part_checks.rst>`), or re-run any code (:doc:`like expression tests </expression_tests.md>).
+They usually don't focus on specific pieces of a submission (:doc:`like part checks <part_checks`), or re-run any code (:doc:`like expression tests <expressions>`).
 Instead, they simply look at things like imports, printed output, or raw code text.
 A final, common use is to test the value of a variable in the final environment (that is, after the submission of solution code have been run).
 
 .. toctree::
+    :hidden:
     :maxdepth: 2
 
     test_import

docs/source/simple_tests/test_object.md

@@ -98,29 +98,25 @@ As explained in the [Processes article](../expression_tests.md), objects are ext
 
 **NOTE**: Behind the scenes, `pythonwhat` has to fetch the value of objects from sub-processes. The required 'dilling' and 'undilling' can cause issues for exotic objects. For more information on this and possible errors that can occur, read the [Processes article](../expression_tests.md).
 
-check_object
-------------
+### check_object syntax
 
 ```eval_rst
 .. autofunction:: pythonwhat.check_object.check_object
 ```
 
-is_instance
------------
+#### is_instance
 
 ```eval_rst
 .. autofunction:: pythonwhat.check_object.is_instance
 ```
 
-has_key
------------
+#### has_key
 
 ```eval_rst
 .. autofunction:: pythonwhat.check_object.has_key
 ```
 
-has_equal_key
----------------
+#### has_equal_key
 
 ```eval_rst
 .. autofunction:: pythonwhat.check_object.has_equal_key