doc: improved discoverability of the odoo integration steps

frePPLe · Feb 14, 2024 · 7d6ba6e · 7d6ba6e
1 parent ef48f56
commit 7d6ba6e
Show file tree

Hide file tree

Showing 3 changed files with 16 additions and 6 deletions.
diff --git a/doc/apps/odoo.rst b/doc/apps/odoo.rst
@@ -6,4 +6,11 @@ This app enables two-way integration with the Odoo, a
 popular open source ERP and business management suite.
 
 See `this chapter <../erp-integration/odoo-connector/index.html>`_
-for full details on configuring and using this integration.
+for full details on this integration.
+
+.. Important::
+
+   This apps requires configuring steps on both odoo and frepple side
+
+   Be sure to follow all steps on `this page <../erp-integration/odoo-connector/installation-and-configuration.html>`_
+   after installation of this app.
diff --git a/doc/erp-integration/odoo-connector/installation-and-configuration.rst b/doc/erp-integration/odoo-connector/installation-and-configuration.rst
@@ -109,6 +109,9 @@ The section below describes the installation and configuration of these.
            CSRF_COOKIE_SAMESITE = "none"               # NOTE: "none", not None
 
   * **Configure parameters**
+    | Some parameters need to be configured in the "admin / parameters" screen. The
+      first 5 parameters absolutely need editing, while the remaining parameters optionally
+      need modification.
 
     * | odoo.url:
       | URL of the Odoo server.
@@ -126,15 +129,15 @@ The section below describes the installation and configuration of these.
         setting ODOO_PASSWORDS in the djangosettings.py file rather then this
         parameter.
 
+    * | odoo.company:
+      | Company name for which to create purchase quotation and
+        manufacturing orders.
+
     * | odoo.language:
       | Language for the connection.
       | If translated names of products, items, locations, etc they will be used.
       | The default value is en_US.
 
-    * | odoo.company:
-      | Company name for which to create purchase quotation and
-        manufacturing orders.
-
     * | odoo.singlecompany:
       | When false (the default) the connector downloads all allowed companies for the odoo integration
         user.

diff --git a/freppledb/odoo/__init__.py b/freppledb/odoo/__init__.py
@@ -32,6 +32,6 @@
         <p>This app enables two-way integration with the Odoo, a popular
         open source ERP and business management suite.</p>
         """,
-    "documentation_url": "https://frepple.com/docs/current/erp-integration/odoo-connector/index.html",
+    "documentation_url": "https://frepple.com/docs/current/apps/odoo.html",
     "ERP_integration": True,
 }