odoo · nmarotte · Sep 7, 2023 · Sep 14, 2023 · Sep 14, 2023 · Sep 14, 2023
diff --git a/content/administration.rst b/content/administration.rst
@@ -18,5 +18,4 @@ These guides provide instructions on how to install, maintain and upgrade Odoo d
 
     administration/install
     administration/maintain
-    administration/upgrade
     administration/odoo_sh
diff --git a/content/administration/maintain/odoo_online.rst b/content/administration/maintain/odoo_online.rst
@@ -31,7 +31,7 @@ Trigger a database upgrade.
 
 .. seealso::
    For more information about the upgrade process, check out the :doc:`Odoo Online upgrade
-   documentation <../upgrade/odoo_online>`.
+   documentation <../../upgrade/request/odoo_online>`.
 
 .. _odoo_online/duplicate:
 

diff --git a/content/administration/maintain/supported_versions.rst b/content/administration/maintain/supported_versions.rst
@@ -12,7 +12,7 @@ Odoo provides support and bug fixing **for the 3 last major versions** of Odoo.
    <odoo_online>` hosting every two months. Odoo Online users can then benefit from the latest
    features of Odoo.
 
-   - Admins of Odoo Online databases are invited to :doc:`upgrade <../upgrade>` them regularly.
+   - Admins of Odoo Online databases are invited to :doc:`upgrade </upgrade>` them regularly.
    - Online versions are *not* released for Odoo.sh and On-Premise installations.
    - Online versions are listed below as *SaaS*.
 

diff --git a/content/administration/odoo_sh/getting_started/branches.rst b/content/administration/odoo_sh/getting_started/branches.rst
@@ -295,7 +295,7 @@ Upgrade
 Available for production and staging branches for valid projects.
 
 .. seealso::
-    :doc:`Upgrade - Odoo.sh <../../upgrade/odoo_sh>`
+    :doc:`Upgrade - Odoo.sh <../../../upgrade/request/odoo_sh>`
 
 .. _odoosh-gettingstarted-branches-tabs-settings:
 

diff --git a/content/administration/upgrade.rst b/content/administration/upgrade.rst
diff --git a/content/administration/upgrade/test-assistance.png b/content/administration/upgrade/test-assistance.png
diff --git a/content/applications/finance/fiscal_localizations/egypt.rst b/content/applications/finance/fiscal_localizations/egypt.rst
@@ -32,11 +32,11 @@ Odoo is compliant with the **Egyptian Tax Authority (ETA) e-invoicing** requirem
 
 .. important::
    Egyptian e-invoicing is available from Odoo 15.0. If needed, :doc:`upgrade
-   </administration/upgrade>` your database.
+   </upgrade>` your database.
 
 .. seealso::
    - `Video: Egypt E-invoicing <https://www.youtube.com/watch?v=NXuBPLR4pVw>`_
-   - :doc:`/administration/upgrade`
+   - :doc:`/upgrade`
 
 .. _egypt/e-invoicing-eta-portal:
 

diff --git a/content/index.rst b/content/index.rst
@@ -9,5 +9,6 @@ Odoo Documentation
 
     applications
     administration
+    upgrade
     developer
     contributing
diff --git a/content/upgrade.rst b/content/upgrade.rst
@@ -0,0 +1,23 @@
+:nosearch:
+:show-content:
+:hide-page-toc:
+:show-toc:
+
+.. |assistance-contact| replace::
+   If you need Odoo assistance on this matter, please get in touch with your Odoo Account Manager or
+   our `Sales department`_.
+.. _Sales department: mailto:sales@odoo.com
+
+=======
+Upgrade
+=======
+
+.. toctree::
+
+    upgrade/introduction
+    upgrade/preparing
+    upgrade/request
+    upgrade/advanced
+    upgrade/assistance
+    upgrade/faq
+    upgrade/sla
diff --git a/content/upgrade/advanced.rst b/content/upgrade/advanced.rst
@@ -0,0 +1,14 @@
+========
+Advanced
+========
+
+.. toctree::
+    :titlesonly:
+
+    advanced/upgrade_process
+    advanced/odoo_shell
+    advanced/util_package
+    advanced/migration_scripts
+    advanced/upgrade_data
+    advanced/upgrade_studio
+    advanced/upgrade_custom_code