Update documentation and added steps to use the vagrant file

docs/releases/1.1.rst

@@ -48,6 +48,7 @@ What's new in Mayan EDMS v1.1
 * New home view
 * Explicit document types needed per index
 * Events app
+* Vagrant file included
 
 
 Upgrading from a previous version

docs/topics/development.rst

@@ -62,6 +62,46 @@ Steps to deploy a development version
     $ ./manage.py runserver
 
 
+Setting up a development version using Vagrant
+----------------------------------------------
+Make sure you have Vagrant and a provider properly installed as per https://docs.vagrantup.com/v2/installation/index.html
+
+Start and provision a machine using:
+
+.. code-block:: bash
+
+    $ vagrant up
+
+To launch a standalone development server
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+    $ vagrant ssh
+    vagrant@vagrant-ubuntu-trusty-32:~$ cd ~/mayan-edms/
+    vagrant@vagrant-ubuntu-trusty-32:~$ source venv/bin/activate
+    vagrant@vagrant-ubuntu-trusty-32:~$ ./manage.py runserver 0.0.0.0:8000
+
+To launch a development server with a celery worker and Redis as broker
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+    $ vagrant ssh
+    vagrant@vagrant-ubuntu-trusty-32:~$ cd ~/mayan-edms/
+    vagrant@vagrant-ubuntu-trusty-32:~$ source venv/bin/activate
+    vagrant@vagrant-ubuntu-trusty-32:~$ ./manage.py runserver 0.0.0.0:8000 --settings=mayan.settings.celery_redis
+
+Then on a separate console launch a celery worker from the same provisioned Vagrant machine:
+
+.. code-block:: bash
+
+    $ vagrant ssh
+    vagrant@vagrant-ubuntu-trusty-32:~$ cd ~/mayan-edms/
+    vagrant@vagrant-ubuntu-trusty-32:~$ source venv/bin/activate
+    vagrant@vagrant-ubuntu-trusty-32:~$ DJANGO_SETTINGS_MODULE='mayan.settings.celery_redis' celery -A mayan worker -l DEBUG -Q checkouts,mailing,uploads,converter,ocr,tools,indexing,metadata -Ofair
+
+
 Contributing changes
 --------------------
 Once your have create and committed some new code or feature, submit a Pull Request.

docs/topics/installation.rst

@@ -40,7 +40,6 @@ it very easy to start using **Mayan EDMS**. Populate the database with the proje
 Point your browser to http://127.0.0.1:8000. If everything was installed
 correctly you should see the login screen and panel showing a randomly generated admin password.
 
-=======
 Mac OSX
 -------
 
@@ -76,7 +75,7 @@ to /usr/bin/ with ...
     sudo ln -s /opt/local/bin/tesseract /usr/bin/tesseract  && \
     sudo ln -s /opt/local/bin/identify /usr/bin/identify && \
     sudo ln -s /opt/local/bin/gs /usr/bin/gs
-    
+
 ... alternatively set the paths in the ``settings/locals.py``
 
 .. code-block:: python
@@ -111,7 +110,7 @@ to /usr/bin/ with ...
     sudo ln -s /usr/local/bin/unpaper /usr/bin/unpaper && \
     sudo ln -s /usr/local/bin/pdftotext /usr/bin/pdftotext && \
     sudo ln -s /usr/local/bin/gs /usr/bin/gs && \
-    
+
 ... alternatively set the paths in the ``settings/locals.py``
 
 .. code-block:: python