wip[IMP] upgrade documentation

Author: nmarotte

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:
 

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:
 

content/administration/upgrade.rst

@@ -12,10 +12,10 @@ Upgrade
 .. toctree::
    :titlesonly:
 
-   upgrade/odoo_online
-   upgrade/odoo_sh
-   upgrade/on_premise
-   upgrade/faq
+   ../upgrade/request/odoo_online
+   ../upgrade/request/odoo_sh
+   ../upgrade/request/on_premise
+   ../upgrade/faq
 
 An upgrade is switching to a newer version of Odoo (e.g., Odoo 14.0 to Odoo 15.0).
 
@@ -54,9 +54,9 @@ The upgrade process in a nutshell:
    newly upgraded database (this is done automatically on Odoo Online).
 
 .. seealso::
-   - :doc:`Upgrade process for Odoo Online <upgrade/odoo_online>`
-   - :doc:`Upgrade process for Odoo.sh <upgrade/odoo_sh>`
-   - :doc:`Upgrade process for On-Premise <upgrade/on_premise>`
+   - :doc:`Upgrade process for Odoo Online <../upgrade/request/odoo_online>`
+   - :doc:`Upgrade process for Odoo.sh <../upgrade/request/odoo_sh>`
+   - :doc:`Upgrade process for On-Premise <../upgrade/request/on_premise>`
 
 .. _upgrade/testing-phase:
 
@@ -105,7 +105,7 @@ Request a test database
 Follow the instructions available per hosting type on the `website form
 <https://upgrade.odoo.com>`_ and select *Testing* purpose.
 
-.. image:: upgrade/test-purpose.png
+.. image:: ../upgrade/request/test-purpose.png
    :align: center
    :alt: Selection of the "Testing" purpose in the upgrade form on Odoo
 
@@ -131,7 +131,7 @@ via the `Odoo Support page <https://www.odoo.com/help>`_.
 
 Under the *Ticket Description* section, select *An issue related to my upgrade* ticket type.
 
-   .. image:: upgrade/test-assistance.png
+   .. image:: ../upgrade/request/test-assistance.png
       :align: center
       :alt: Selection of "An issue related to my upgrade" as Ticket Type in the support form on Odoo
 
@@ -259,6 +259,6 @@ The following upgrade-related services are **not** included:
 .. note:: |assistance-contact|
 
 .. seealso::
-   - :doc:`Upgrade FAQ <upgrade/faq>`
+   - :doc:`Upgrade FAQ <../upgrade/faq>`
    - :doc:`Odoo.sh documentation <odoo_sh>`
    - :doc:`Supported Odoo versions <maintain/supported_versions>`

content/index.rst

@@ -9,5 +9,6 @@ Odoo Documentation
 
     applications
     administration
+    upgrade
     developer
     contributing

content/upgrade.rst

@@ -0,0 +1,38 @@
+: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
+=======
+
+These guides provide information on the upgrade process of your Odoo database as a whole, from planning and
+allocating resources for an upgrade, all the way to the post-upgrade support
+
+TODO added this that was from the old upgrade page
+
+An upgrade does not cover:
+
+* Changing :ref:`editions <upgrade-faq/editions-change>` (i.e., Community to Enterprise edition)
+* Switching :ref:`hosting type <upgrade-faq/hosting-types-switch>` (i.e., On-Premise to Odoo Online
+  or Odoo.sh)
+* Migration from another ERP to Odoo
+
+.. note:: |assistance-contact|
+
+.. seealso::
+   - :ref:`upgrade/sla`
+
+.. toctree::
+
+    upgrade/introduction
+    upgrade/full_process
+    upgrade/version_target
+    upgrade/request
+    upgrade/advanced

content/upgrade/advanced.rst

@@ -0,0 +1,13 @@
+========
+Advanced
+========
+
+.. toctree::
+    :titlesonly:
+
+    advanced/odoo_shell
+    advanced/util_package
+    advanced/migration_scripts
+    advanced/upgrade_data
+    advanced/upgrade_studio_views
+    advanced/upgrade_custom_code

content/upgrade/advanced/migration_scripts.rst

@@ -0,0 +1,3 @@
+============================
+What are Migration Scripts ?
+============================

content/upgrade/advanced/odoo_shell.rst

@@ -0,0 +1,25 @@
+==========
+Odoo Shell
+==========
+
+If you're familiar with Odoo, you probably know the user-friendly Graphical User Interface (GUI), which is the web page where you carry out your operations in Odoo, commonly referred to as the web client or front-end.
+
+.. image:: odoo_shell/odoo-web-client.png
+   :alt: The Odoo web client we all know and love
+   :align: center
+
+The front-end simplifies complex operations like invoice validation, product transfers, and more, often triggered by a single button click. However, beneath this simplicity lies a significant amount of code execution, sometimes involving hundreds of lines!
+
+Occasionally, you might face situations where you need to perform a straightforward operation on numerous records, such as checking a checkbox for each project in the Project App. Manually navigating menus for such tasks can be time-consuming and tedious 🥱
+
+At Odoo, we value efficiency, and this is where the "Odoo Shell" comes into play. For seasoned Odoo users, it's a handy trick. The Odoo Shell allows direct interaction with the Object-Relational-Mapping (ORM), enabling you to manipulate data almost as if you were working directly within Odoo's source code. With just a few lines of code, you can, for instance, update all contact names in your database by adding an exclamation mark to each. This operation would take seconds in the Odoo Shell but potentially hours in the front-end. The Odoo Shell is a true blessing ! 🙏
+
+.. image:: odoo_shell/odoo-shell-example.png
+   :alt: An example of the use of the shell of Odoo : multiple lines of Python code that change the name of each partner to add an exclamation mark at the end of each partner
+   :align: center
+
+The Odoo Shell is essentially an extension of the `IPython shell <https://ipython.readthedocs.io/en/stable/>`_, directly connected to the Odoo database. While it's somewhat similar to creating a server or automated action and executing it, the Odoo Shell offers the flexibility to write code incrementally, exploring Odoo's inner workings. It's a valuable tool for developing migration scripts, allowing you to test the code you wrote before starting the whole upgrade process instead of risking a full database upgrade only to discover a minor coding error.
+
+Accessing the Odoo Shell depends on your hosting type. For On-Premise databases, you can add the "shell" keyword as the first parameter when executing your instance. For instance, if you use `./odoo-bin -d my_database`, you can simply use `./odoo-bin shell -d my_database`. On Odoo SH, it's even simpler, as you have direct access to a bash terminal via the "Shell" tab. Once in the terminal, you can run the command `odoo-bin shell` to gain immediate access to your database's Odoo Shell. Convenient, isn't it?
+
+The Odoo shell is not applicable to Odoo Online since users only have access to the web client, and not the server running their Odoo database.