doc fixes

Author: pancetta

docs/source/index.rst

@@ -90,7 +90,7 @@ Tests
 API documentation
 -----------------
 
-.. include:: ../../pySDC/README.rst
+.. include:: ../../pySDC/README_API.rst
 
 .. toctree::
    :maxdepth: 1

pySDC/README.rst

@@ -4,14 +4,5 @@ Many implementations of e.g. sweepers, data types or problems can be found in ``
 These contain the specialized ingredients for a user-defined setup, e.g. an LU-based MLSDC run for the generalized Fisher's equation with Gauss-Radau nodes.
 In ``helpers``, we can find helper functions used by the core routines, the implementations or by the user.
 
-The Python files contained in these three packages are fully documented and their API is generated automatically with sphinx-apidoc after each update.
-The API (as well as the tutorial pages) can also be generated manually and locally by executing
-
-.. code-block:: none
-
-   > ./docs/update_apidocs.sh
-   > nosetests tests -v --with-id --with-coverage --cover-inclusive --cover-package=pySDC,tutorial --cover-html --cover-html-dir=target/doc/build/test_coverage
-   > travis-sphinx build
-
-in the root directory. Then, the main index can be found in ``target/doc/build/index.html``. Anyway, here is the online version:
-
+Then, in ``playgrounds`` there are various small to medium experiments done with pySDC. They are for example grouped by application (e.g. ``Boris``) or by problem type (e.g. ``ODEs``).
+In ``projects`` we gather focussed experiments with pySDC which go beyond simple toy problems or feature tests, while ``tutorial`` contains the files and data for the tutorial codes.

pySDC/README_API.rst

@@ -0,0 +1,11 @@
+The Python files contained in ``core``, ``implementations`` and ``helpers`` are fully documented and their API is generated automatically with sphinx-apidoc after each update.
+The API (as well as the tutorial pages) can also be generated manually and locally by executing
+
+.. code-block:: none
+
+   > ./docs/update_apidocs.sh
+   > nosetests -v --with-id --with-coverage --cover-inclusive --cover-package=core,implementations,helpers,tutorial --cover-html --cover-html-dir=target/doc/build/test_coverage pySDC/
+   > travis-sphinx build
+
+in the root directory. Then, the main index can be found in ``target/doc/build/index.html``. Anyway, here is the online version:
+