[IMP] developer: add notes on entity references & fix illegal XML

Using `<` inside XML elements will result in a parsing error,
an entity reference should be used instead: `&lt;`.

Signed-off-by: Levi Siuzdak (sile) <sile@odoo.com>
X-original-commit: a7743d513b

Makefile

@@ -26,7 +26,7 @@ SOURCE_DIR     = content
 
 HTML_BUILD_DIR = $(BUILD_DIR)/html
 ifdef VERSIONS
-  HTML_BUILD_DIR := $(HTML_BUILD_DIR)/master
+  HTML_BUILD_DIR := $(HTML_BUILD_DIR)/saas-16.4
 endif
 ifneq ($(CURRENT_LANG),en)
   HTML_BUILD_DIR := $(HTML_BUILD_DIR)/$(CURRENT_LANG)

conf.py

@@ -22,7 +22,7 @@ copyright = 'Odoo S.A.'
 # `version` is the version info for the project being documented, acts as replacement for |version|,
 # also used in various other places throughout the built documents.
 # `release` is the full version, including alpha/beta/rc tags. Acts as replacement for |release|.
-version = release = 'master'
+version = release = 'saas-16.4'
 
 # `current_branch` is the technical name of the current branch.
 # E.g., saas-15.4 -> saas-15.4; 12.0 -> 12.0, master -> master (*).
@@ -213,6 +213,7 @@ sphinx.transforms.i18n.docname_to_domain = (
 # is populated. If a version is passed to `versions` but is not listed here, it will not be shown.
 versions_names = {
     'master': "Master",
+    'saas-16.4': "Odoo Online",
     'saas-16.3': "Odoo Online",
     'saas-16.2': "Odoo Online",
     'saas-16.1': "Odoo Online",

content/developer/reference/backend/views.rst

@@ -2325,11 +2325,14 @@ Possible children elements of the search view are:
 
           <filter domain="[('state', '=', 'draft')]"/>
           <separator/>
-          <filter domain="[('delay', '<', 15)]"/>
+          <filter domain="[('delay', '&lt;', 15)]"/>
 
        if both filters are selected, will select the records whose ``state``
        is ``draft`` **and** ``delay`` is below 15.
 
+       .. note:: XML does not allow ``<`` to be used within XML elements,
+          an entity reference (``&lt;``) should be used instead.
+
 ``separator``
     can be used to separates groups of filters in simple search views
 

content/developer/tutorials/getting_started/07_basicviews.rst

@@ -218,6 +218,16 @@ services *OR* have a unit price which is *NOT* between 1000 and 2000'::
             ('unit_price', '>=', 1000),
             ('unit_price', '<', 2000)]
 
+.. note:: XML does not allow ``<`` and ``&`` to be used inside XML
+    elements. To avoid parsing errors, entity references should be used:
+    ``&lt;`` for ``<`` and ``&amp;`` for ``&``. Other entity references
+    (``&gt;``, ``&apos;`` & ``&quot;``) are optional.
+
+    .. example::
+        .. code-block:: xml
+
+            <filter name="negative" domain="[('test_val', '&lt;', 0)]"/>
+
 .. exercise:: Add filter and Group By.
 
     The following should be added to the previously created search view: