From 321cbbc0cb1b229cb798f07b9d8317663827118e Mon Sep 17 00:00:00 2001
From: Iago Veloso <iago.veloso@thisisglobal.com>
Date: Fri, 9 Jun 2017 20:30:39 +0100
Subject: [PATCH] Adding release notes for version 3.1

---
 docs/source/api/index.rst                     | 15 +++++++
 docs/source/source_code/radioco.apps.api.rst  |  8 ----
 .../source_code/radioco.apps.api.tests.rst    |  8 ++++
 .../radioco.apps.radioco.migrations.rst       | 22 ++++++++++
 .../source_code/radioco.configs.base.rst      |  8 ++++
 .../source_code/radioco.configs.openshift.rst | 22 ++++++++++
 .../source_code/radioco.configs.staging.rst   | 38 ++++++++++++++++++
 docs/source/upgrade/3.1.rst                   | 40 +++++++++++++++++++
 docs/source/upgrade/index.rst                 |  1 +
 radioco/__init__.py                           |  2 +-
 radioco/apps/radioco/tz_utils.py              |  2 +-
 11 files changed, 156 insertions(+), 10 deletions(-)
 create mode 100644 docs/source/source_code/radioco.apps.radioco.migrations.rst
 create mode 100644 docs/source/source_code/radioco.configs.openshift.rst
 create mode 100644 docs/source/source_code/radioco.configs.staging.rst
 create mode 100755 docs/source/upgrade/3.1.rst

diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst
index b64e5d8..e7cf6f9 100644
--- a/docs/source/api/index.rst
+++ b/docs/source/api/index.rst
@@ -51,3 +51,18 @@ Finally, there is a endpoint to get the current transmission:
 
     http://127.0.0.1:8000/api/2/transmissions/now
 
+
+************
+Radiocom API
+************
+*New in version 3.1*
+
+`Radiocom <https://github.com/ficiverson/radiocom-android>`_ is an Android application for Community Media Stations.
+RadioCo has the `Radiocom API <https://github.com/ficiverson/radiocom-android>`_ under the following urls:
+
+.. code-block:: bash
+
+    http://127.0.0.1:8000/api/2/radiocom/programmes
+    http://127.0.0.1:8000/api/2/radiocom/radiostation
+    http://127.0.0.1:8000/api/2/radiocom/transmissions
+    http://127.0.0.1:8000/api/2/radiocom/transmissions/now
diff --git a/docs/source/source_code/radioco.apps.api.rst b/docs/source/source_code/radioco.apps.api.rst
index ee0088c..c9a8f0f 100644
--- a/docs/source/source_code/radioco.apps.api.rst
+++ b/docs/source/source_code/radioco.apps.api.rst
@@ -11,14 +11,6 @@ Subpackages
 Submodules
 ----------
 
-radioco.apps.api.radiocom_views module
---------------------------------------
-
-.. automodule:: radioco.apps.api.radiocom_views
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
 radioco.apps.api.recorder_views module
 --------------------------------------
 
diff --git a/docs/source/source_code/radioco.apps.api.tests.rst b/docs/source/source_code/radioco.apps.api.tests.rst
index 992e201..07965b1 100644
--- a/docs/source/source_code/radioco.apps.api.tests.rst
+++ b/docs/source/source_code/radioco.apps.api.tests.rst
@@ -28,6 +28,14 @@ radioco.apps.api.tests.test_programmes module
     :undoc-members:
     :show-inheritance:
 
+radioco.apps.api.tests.test_radiocom_api module
+-----------------------------------------------
+
+.. automodule:: radioco.apps.api.tests.test_radiocom_api
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 radioco.apps.api.tests.test_recorder module
 -------------------------------------------
 
diff --git a/docs/source/source_code/radioco.apps.radioco.migrations.rst b/docs/source/source_code/radioco.apps.radioco.migrations.rst
new file mode 100644
index 0000000..ebcb934
--- /dev/null
+++ b/docs/source/source_code/radioco.apps.radioco.migrations.rst
@@ -0,0 +1,22 @@
+radioco.apps.radioco.migrations package
+=======================================
+
+Submodules
+----------
+
+radioco.apps.radioco.migrations.0001__v3_0__mysql_timezone module
+-----------------------------------------------------------------
+
+.. automodule:: radioco.apps.radioco.migrations.0001__v3_0__mysql_timezone
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: radioco.apps.radioco.migrations
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/docs/source/source_code/radioco.configs.base.rst b/docs/source/source_code/radioco.configs.base.rst
index a82aad8..20e21ac 100644
--- a/docs/source/source_code/radioco.configs.base.rst
+++ b/docs/source/source_code/radioco.configs.base.rst
@@ -20,6 +20,14 @@ radioco.configs.base.settings module
     :undoc-members:
     :show-inheritance:
 
+radioco.configs.base.test_runner module
+---------------------------------------
+
+.. automodule:: radioco.configs.base.test_runner
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 radioco.configs.base.urls module
 --------------------------------
 
diff --git a/docs/source/source_code/radioco.configs.openshift.rst b/docs/source/source_code/radioco.configs.openshift.rst
new file mode 100644
index 0000000..23147c4
--- /dev/null
+++ b/docs/source/source_code/radioco.configs.openshift.rst
@@ -0,0 +1,22 @@
+radioco.configs.openshift package
+=================================
+
+Submodules
+----------
+
+radioco.configs.openshift.settings module
+-----------------------------------------
+
+.. automodule:: radioco.configs.openshift.settings
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: radioco.configs.openshift
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/docs/source/source_code/radioco.configs.staging.rst b/docs/source/source_code/radioco.configs.staging.rst
new file mode 100644
index 0000000..00a0189
--- /dev/null
+++ b/docs/source/source_code/radioco.configs.staging.rst
@@ -0,0 +1,38 @@
+radioco.configs.staging package
+===============================
+
+Submodules
+----------
+
+radioco.configs.staging.manage module
+-------------------------------------
+
+.. automodule:: radioco.configs.staging.manage
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+radioco.configs.staging.settings module
+---------------------------------------
+
+.. automodule:: radioco.configs.staging.settings
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+radioco.configs.staging.wsgi module
+-----------------------------------
+
+.. automodule:: radioco.configs.staging.wsgi
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: radioco.configs.staging
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/docs/source/upgrade/3.1.rst b/docs/source/upgrade/3.1.rst
new file mode 100755
index 0000000..4df03a0
--- /dev/null
+++ b/docs/source/upgrade/3.1.rst
@@ -0,0 +1,40 @@
+#################
+3.1 release notes
+#################
+
+*****************
+What's new in 3.1
+*****************
+
+*   Fixing staging docker port issue. (Thanks to `@mmontes11 <https://github.com/mmontes11>` for report)
+*   Adding stable `Radiocom API <https://github.com/ficiverson/radiocom-android>`_
+*   Solving ticket `#43 <https://github.com/iago1460/django-radio/issues/43>`_
+*   Upgrading libraries to last version
+*   Small fixes to invoke scripts
+*   Improving API (Outputting absolute urls and adding some fields)
+
+
+********************
+How this affects you
+********************
+
+If you’re starting with a new installation, you don’t need to worry about this. 
+Don’t even bother reading this section; it’s for upgraders.
+
+You need to replace your current source with the content of https://github.com/iago1460/django-radio.
+To setup your settings please read the configuration section.
+
+You should be able to keep your current database but make sure to create a backup before start.
+
+.. code-block:: bash
+
+    pip install -r radioco/configs/base/requirements.txt
+    python manage.py collectstatic
+    python manage.py migrate
+
+Or if you are using our docker setup:
+
+.. code-block:: bash
+
+    inv docker.clean -e staging
+    inv docker.setup -e staging
diff --git a/docs/source/upgrade/index.rst b/docs/source/upgrade/index.rst
index f682627..06c8957 100755
--- a/docs/source/upgrade/index.rst
+++ b/docs/source/upgrade/index.rst
@@ -18,3 +18,4 @@ on any process that makes changes to your database.
     2.1
     3.0
     3.0.1
+    3.1
diff --git a/radioco/__init__.py b/radioco/__init__.py
index 7db1208..3c3770f 100755
--- a/radioco/__init__.py
+++ b/radioco/__init__.py
@@ -15,4 +15,4 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 
-__version__ = '3.0.1'
+__version__ = '3.1'
diff --git a/radioco/apps/radioco/tz_utils.py b/radioco/apps/radioco/tz_utils.py
index eab5c5a..928de1a 100644
--- a/radioco/apps/radioco/tz_utils.py
+++ b/radioco/apps/radioco/tz_utils.py
@@ -135,7 +135,7 @@ def recurrence_after(recurrence, after_dt, start_dt):
 def recurrence_before(recurrence, before_dt, start_dt):
     """
     Fix for django-recurrence 1.3
-    Avoid outputting a non impossible dt
+    Avoid outputting a impossible dt
     """
     dt = recurrence.before(before_dt, True, dtstart=start_dt)
     if dt == start_dt: