improvements on documentation

- "database" section including the schema
- "about" included in API docs

ippisite/docs/README.md

+How to update and build the documentation for iPPI-DB
+=====================================================
+
+- update the database graphical representation
+python ../manage.py graph_models ippidb --pygraphviz --output source/db.dot
+- build the docs
+make html
+
+The main page of the documentation is in build/html/index.html.

ippisite/docs/source/conf.py

@@ -50,6 +50,7 @@ extensions = [
     'sphinx.ext.intersphinx',
     'sphinx.ext.coverage',
     'sphinx.ext.viewcode',
+    'sphinx.ext.graphviz'
 ]
 
 # Add any paths that contain templates here, relative to this directory.

ippisite/docs/source/database.rst

+iPPI-DB database
+================
+
+.. graphviz:: db.dot
+

ippisite/docs/source/index.rst

@@ -3,14 +3,20 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to iPPI-DB's documentation!
-===================================
+Welcome to the iPPI-DB technical documentation!
+===============================================
+
+iPPI-DB is an online database of modulators of protein-protein interactions.
+The database itself and its description are hosted at https://ippidb.pasteur.fr.
+
+These pages contain the documentation for technical maintenance and development purposes.
 
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
 
    install
+   database
    modules
 
 

ippisite/docs/source/modules.rst

-IPPIDB Python API reference
-===========================
+iPPI-DB Python API reference
+============================
 
 .. automodule:: ippidb
     :members:

ippisite/ippidb/views/__init__.py

@@ -4,6 +4,7 @@ iPPI-DB views
 .. autosummary::
     :toctree: _autosummary
 
+    about
     contribute
     compound_query
 """

ippisite/ippisite/settings.py

@@ -158,7 +158,7 @@ STATIC_ROOT = os.path.join(BASE_DIR, 'static_root')
 #$ ./manage.py graph_models -a > db.dot
 #$ dot db.dot -T png -odb.png
 GRAPH_MODELS = {
-  'all_applications': True,
+  'all_applications': False,
   'group_models': True,
 }