From 7d6ba6e27c1aa20da99db2d653561cf5d30c6ac5 Mon Sep 17 00:00:00 2001
From: Johan De Taeye <jdetaeye@frepple.com>
Date: Wed, 14 Feb 2024 10:06:03 +0100
Subject: [PATCH] doc: improved discoverability of the odoo integration steps

---
 doc/apps/odoo.rst                                     |  9 ++++++++-
 .../odoo-connector/installation-and-configuration.rst | 11 +++++++----
 freppledb/odoo/__init__.py                            |  2 +-
 3 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/doc/apps/odoo.rst b/doc/apps/odoo.rst
index 688a699fa8..79a1ae76d9 100644
--- 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
index a669308253..3bbb7e59da 100644
--- 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
index bc34005428..24b492a101 100644
--- 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,
 }