finalize release notes

CHANGES.rst

@@ -2,6 +2,10 @@
 Changelog
 ---------
 
+1.4.0
+*****
+- Additional multilingual functionality (GitHub issues 704, 705, 779)
+
 1.3.1
 *****
 - Maintenance release (GitHub issues 447, 610, 590, 609, 757, 750, 681, 752, 753, 460, 736,

doc/source/changes.rst

@@ -13,26 +13,31 @@ version. Often a version upgrade changes or adds parameters which are used.
 Version 1.4.0
 -------------
 
-* properties map.legend_at_web (issue #704) and sub_theme (issue #705) are now multilingual:
+* properties ``map.legend_at_web`` and ``sub_theme`` are now multilingual:
   ``legend_at_web`` now supports one link per language. The ``sub_theme`` is shown in the requested (or default)
   language.
 
-  In the database the field types changed from ``VARCHAR`` to ``JSON``. You need to adapt your data
+  In the database, the field types changed from ``VARCHAR`` to ``JSON``. You need to adapt your data
   generation or existing data:
 
-  * ``legend_at_web`` changes from ``http://your_link`` to ``{'language': 'http://your_link'}`` or
+  * ``legend_at_web`` changes from ``http://your_link`` to ``{'language': 'http://your_link'}``
+    if you have only one language, or
     ``{'languageA': 'http://link_A', 'languageB': 'http://link_B'}`` if you have multiple languages.
 
-  * ``sub_theme`` changes from ``Sub theme title`` to ``{'language': 'Sub theme title'}`` or
+  * ``sub_theme`` changes from ``Sub theme title`` to ``{'language': 'Sub theme title'}``
+    if you have only one language, or
     ``{'languageA': 'Sub theme title A', 'languageB': 'Sub theme title B'}`` if you have multiple languages.
 
   Language may be 'de', 'fr', 'it', 'rm' or 'en'.
 
   All models (standard and oereblex) have been adjusted to use ``JSONType`` instead of ``sa.String`` in each model.
-  If you have custom models, adapt them accordingly. See pyramid_oereb/contrib/templates/plr_oereb.py.mako as reference.
+  If you have custom models, adapt them accordingly. See ``pyramid_oereb/contrib/templates/plr_oereb.py.mako``
+  as reference. Remember that if these custom models are oereblex models which were generated by script without
+  any further customization, you can remove these from your custom and switch to the already bundled models,
+  see :ref:`changes-version-1.3.1`, to simplify your upgrade (and all future upgrades).
 
-  The extracts and mapfish print templates are not affected. They only include the legend_at_web or sub_theme of the
-  currently requested language.
+  The extracts and mapfish print templates are not affected. They only include the ``legend_at_web`` or ``sub_theme``
+  of the currently requested language.
 
 
 .. _changes-version-1.3.1: