Update docs

docs/deploy-custom.rst

+Deployment on a custom machine
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Prerequisites
+=============
+
+You will need the following:
+
+* A clone of the git repository at ``https://github.com/political-memory/political_memory.git``
+* a PostgreSQL>=9.2 database (not necessarily on the same machine)
+* a WSGI-capable web server
+
+Setup environment
+=================
+
+Set the following environment variables::
+
+    DJANGO_SETTINGS_MODULE=memopol.settings
+
+Customize settings
+==================
+
+Create a copy of the example local settings file::
+
+    $ cp memopol/local_settings.py.example memopol/local_settings.py
+
+Edit ``memopol/local_settings.py`` to set directories, database settings and
+allowed hosts.  Setup your WSGI server to serve:
+
+* Static files from the directory specified in the ``PUBLIC_DIR`` setting to the
+  ``/static`` URL
+* The memopol/wsgi.py WSGI application
+
+Initial memopol setup
+=====================
+
+Install client libraries::
+
+    $ bin/install_client_deps.sh
+
+Setup the database schema::
+
+    $ ./manage.py migrate --noinput
+
+Collect static files::
+
+    $ ./manage.py collectstatic --noinput
+
+Memopol should be ready to go.
+
+Updating
+========
+
+To update simply pull the repository and run setup commands again::
+
+    $ git pull
+    $ bin/install_client_deps.sh
+    $ ./manage.py migrate --noinput
+    $ ./manage.py collectstatic --noinput
+
+Data provisionning
+==================
+
+Set up two cron jobs:
+
+* One to update data from parliaments, that runs ``bin/update_all``.  This
+  script takes quite some time to run, so you should schedule it once every
+  night for example
+* One to refresh scores,  that runs ``./manage.py refresh_scores``.  This one
+  runs quite quickly (a few seconds), you may want to run it after the update
+  job has completed (but you can run it more often).
+
+Ensure that cron jobs get the same environment as the application.
+
+
+Continue to :doc:`administration`.

docs/deployment.rst → docs/deploy-openshift.rst

@@ -92,4 +92,4 @@ to be executed, either do it manually::
 OpenShift is fun, login with ssh and look around if you're curious, you'll be
 able to recreate your app without much effort if you break it anyway.
 
-Continue to :doc:`administration`.
+Continue to :doc:`deploy-custom`.

docs/index.rst

@@ -12,7 +12,8 @@ Contents:
    :maxdepth: 2
 
    usage
-   deployment
+   deploy-openshift
+   deploy-custom
    administration
    scores
    api