Add release notes for version 3.1.8

Signed-off-by: Roberto Rosario <roberto.rosario.gonzalez@gmail.com>

docs/releases/3.1.6.rst

@@ -36,7 +36,7 @@ Remove deprecated requirements::
 
 Type in the console::
 
-    $ pip install mayan-edms==3.1.5
+    $ pip install mayan-edms==3.1.6
 
 the requirements will also be updated automatically.
 

docs/releases/3.1.7.rst

@@ -15,10 +15,10 @@ Changes
   @TheOneValen for the report.
 * Ignore document stub from the index mirror. GitLab issue
   #520. Thanks to TheOneValen @TheOneValen for the report.
-* Fix for the Docker image INSTALL_FLAG path. Thanks to 
+* Fix for the Docker image INSTALL_FLAG path. Thanks to
   Mark Maglana @relaxdiego for the report and to Hamish Farroq @farroq_HAM
   for the patch. GitLab issue #525.
-* Fix the typo in the Docker variable for worker concurrency. Thanks to 
+* Fix the typo in the Docker variable for worker concurrency. Thanks to
   Mark Maglana @relaxdiego for the report and to Hamish Farroq @farroq_HAM
   for the patch. GitLab issue #527.
 * Add a noop OCR backend that disables OCR and the check for the
@@ -44,7 +44,7 @@ Remove deprecated requirements::
 
 Type in the console::
 
-    $ pip install mayan-edms==3.1.5
+    $ pip install mayan-edms==3.1.7
 
 the requirements will also be updated automatically.
 

docs/releases/3.1.8.rst

@@ -0,0 +1,80 @@
+===============================
+Mayan EDMS v3.1.8 release notes
+===============================
+
+Released: October XX, 2018
+
+Changes
+~~~~~~~
+
+
+Removals
+--------
+
+* None
+
+Upgrading from a previous version
+---------------------------------
+
+
+If installed via Python's PIP
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Remove deprecated requirements::
+
+    $ curl https://gitlab.com/mayan-edms/mayan-edms/raw/master/removals.txt | pip uninstall -r /dev/stdin
+
+Type in the console::
+
+    $ pip install mayan-edms==3.1.8
+
+the requirements will also be updated automatically.
+
+
+Using Git
+~~~~~~~~~
+
+If you installed Mayan EDMS by cloning the Git repository issue the commands::
+
+    $ git reset --hard HEAD
+    $ git pull
+
+otherwise download the compressed archived and uncompress it overriding the
+existing installation.
+
+Remove deprecated requirements::
+
+    $ pip uninstall -y -r removals.txt
+
+Next upgrade/add the new requirements::
+
+    $ pip install --upgrade -r requirements.txt
+
+
+Common steps
+~~~~~~~~~~~~
+Perform these steps after updating the code from either step above.
+
+Migrate existing database schema with::
+
+    $ mayan-edms.py performupgrade
+
+Add new static media::
+
+    $ mayan-edms.py collectstatic --noinput
+
+The upgrade procedure is now complete.
+
+
+Backward incompatible changes
+-----------------------------
+
+* None
+
+Bugs fixed or issues closed
+===========================
+
+* `GitLab issue #529 <https://gitlab.com/mayan-edms/mayan-edms/issues/529>`_ Submitting a metadata value with the `&` character truncates string
+* `GitLab issue #530 <https://gitlab.com/mayan-edms/mayan-edms/issues/530>`_ Email Link form does not accept commas or semicolons to separate multiple addresses
+
+.. _PyPI: https://pypi.python.org/pypi/mayan-edms/

docs/releases/index.rst

@@ -20,6 +20,7 @@ versions of the documentation contain the release notes for any later releases.
 .. toctree::
    :maxdepth: 1
 
+   3.1.8
    3.1.7
    3.1.6
    3.1.5