[MERGE] Forward-port of branch 14.0 to master

.github/CODEOWNERS

@@ -1,3 +1,11 @@
+# All changes to technical files (build environment and Sphinx extensions) have to be approved
+/extensions/         @odoo/doc-review
+.gitignore           @odoo/doc-review
+commit_template.txt  @odoo/doc-review
+conf.py              @odoo/doc-review
+Makefile             @odoo/doc-review
+requirements.txt     @odoo/doc-review
+
 # All changes to legal material have to be approved
-/legal/     @odoo/legal
+/content/legal/     @odoo/legal
-/legal.rst  @odoo/legal
+/content/legal.rst  @odoo/legal

content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse.rst

@@ -1,131 +1,129 @@
-=====================================
+=========================
-How to do inter-warehouses transfers?
+Inter-warehouse transfers
-=====================================
+=========================
 
-If you own different warehouses you might want to transfer goods from
+When owning several warehouses, you might need to transfer goods from one warehouse to another.
-one warehouse to the other. This is very easy thanks to the inventory
+Proceeding to such behavior is called *inter-warehouse transfers*. If this action is physically
-application in Odoo.
+easy to perform, the administrative part can be arduous. Fortunately, Odoo comes with an intuitive
+flow that helps save time when registering those transfers.
 
 Configuration
 =============
 
-First of all you have to select the multi locations option. Go to
+First of all, go to :menuselection:`Configuration --> Settings` and enable **Storage Locations**.
-:menuselection:`Configuration --> Settings` in the **Inventory application**.
+Then, hit save.
-Then tick the **Manage several locations per
-warehouse** option. Please don't forget to **apply** your changes.
 
-.. image:: media/inter01.png
+.. image:: inter_warehouse/feature-storage-location.png
    :align: center
+   :alt: Enabling the storage location feature in Odoo Inventory.
 
-.. tip::
+.. important::
-   This option should also be ticked if you wish to manage different
+   If you want to manage several routes within your warehouses, then enable **Multi-Step Routes**
-   locations and routes in your warehouse.
+   and check :doc:`use-routes`.
 
 Creating a new warehouse
 ========================
 
-The next step is to create your new warehouse. In the Inventory application
+The next step is to create your new warehouse. To do so, go to :menuselection:`Configuration -->
-click on :menuselection:`Configuration --> Warehouse Management --> 
+Warehouse Management --> Warehouses` and click on **Create**.
-Warehouses`. You are now able to create your warehouse by clicking on
-**Create**.
 
-Fill in a **Warehouse Name** and a **Short Name**. The short name is 5
+Fill out a **Warehouse Name** and a **Short Name**. The short name is five characters maximum.
-characters maximum.
 
-.. image:: media/inter02.png
+.. image:: inter_warehouse/create-new-warehouse.png
    :align: center
+   :alt: Short name field of a warehouse on Odoo Inventory.
 
-.. tip::
+.. important::
-   Please note that the **Short Name** is very important as it will
+   The **Short Name** appears on your transfer orders and other warehouse documents. We recommend
-   appear on your transfer orders and other warehouse documents. It might
+   using an understandable one (e.g.: WH/[first letters of location]).
-   be smart to use an understandable one (e.g.: WH/[first letters of
-   location]).
 
-If you go back to your dashboard, new operations will automatically have
+Now, go back to your dashboard. There, new operations related to your warehouse have been
-been generated for your new warehouse.
+automatically generated.
 
-.. image:: media/inter03.png
+.. image:: inter_warehouse/new-transfer-types.png
    :align: center
+   :alt: Inventory app dashboard displaying new transfer type for the recently created warehouse.
 
 Creating a new inventory
 ========================
 
-If you create a new warehouse you might already have an existing
+If you create a new warehouse, you might already have an existing inventory in it. In that case, you
-physical inventory in it. In that case you should create an inventory in
+should create an inventory in Odoo. If this is not the case, you can skip this step.
-Odoo, if not you can skip this step.
 
-Go into the inventory application, select :menuselection:`Inventory Control -->
+Into the inventory application, select :menuselection:`Operations --> Inventory Adjustment`.
-Inventory Adjustment`. You can then create a new inventory by clicking on
+Then, create a new inventory by clicking on **Create**. Fill in the **Inventory Reference**,
-**Create**. Fill in the **Inventory Reference**, **Date**
+**Date** and make sure to select the right warehouse and location.
-and be sure to select the right warehouse and location.
 
-.. image:: media/inter04.png
+.. image:: inter_warehouse/annual-inventory.png
    :align: center
+   :alt: View of the inventory adjustment form before hitting the start button.
 
-Next, click on **Start Inventory**. A new window will open where you will
+Next, click on **Start Inventory**. You will be able to input your existing products in the new
-be able to input your existing products. Select add an item and indicate
+window. Select add an item and indicate the **Real Quantity** available in the warehouse.
-the **Real Quantity** available in the warehouse. The theoretical quantity
+The theoretical quantity can not be changed as it represents a computed one from purchase and sales
-can not be changed as it represents a computed quantity from purchase
+orders.
-and sales orders.
 
-.. image:: media/inter05.png
+.. image:: inter_warehouse/in-progress-annual-inventory.png
    :align: center
+   :alt: View of the actual physical inventory of the new warehouse.
 
-Don't forget to validate your inventory once you have recorder the state of
+.. tip::
-all yours product.
+   Don't forget to validate your inventory once you have recorded the state of all your products.
 
 Create an internal transfer
 ===========================
 
-The final step is to create your internal transfer. If you want to
+The final step is to create your internal transfer. If you want to transfer eight units of a product
-tranfer 2 units of a product from your first warehouse to another one in
+from your first warehouse to another one, proceed as follows:
-Brussels, proceed as follows:
 
-From your dashboard, select a internal movement of one of the two
+From your dashboard, select an internal movement of one of the two warehouses. To do so, click on
-warehouses. To do so, click on :menuselection:`More  --> Transfer`.
+:menuselection:`Manage  --> Planned Transfer`.
 
-.. image:: media/inter06.png
+.. image:: inter_warehouse/internal-transfer-choice.png
    :align: center
+   :alt: View of the choice between planned transfer and immediate transfer.
 
-A new window will open where you will be able to select the source
+On the new window, select the source location zone (in this case, your "old" warehouse) and the
-location zone (in this case our "old warehouse") and the destination
+destination location zone (in this case, your "new" warehouse).
-location zone (in this case our "new" warehouse located in Brussels).
 
-Add the products you want to transfer by clicking on **Add an Item** and
+Add the products you want to transfer by clicking on **Add an Item**, then click on **Save** and
-don't forget to **Validate** or **Mark as TODO** once you are done.
+**Mark as TODO** once you are done.
 
-.. image:: media/inter07.png
+.. image:: inter_warehouse/planned-internal-transfer.png
    :align: center
+   :alt: View of the internal transfer form.
 
-If you select **Validate**, Odoo will process all quantities to transfer.
+If you selected **Immediate Transfer**, Odoo processes the transfer automatically after you clicked
+on **Validate**.
 
-If you select **Mark as TODO**, Odoo will put the transfer in **Waiting
+If you select **Mark as TODO**, Odoo puts the transfer in **Waiting Availability** status.
-Availability** status. Click on **Reserve** to reserve the amount of
+Click on **Reserve** to reserve the number of products in your source warehouse.
-products in your source warehouse.
 
 It is also possible to manually transfer each product:
 
-1. Via your dashboard, select the transfer order in the source location.
+- Via your dashboard, select the transfer order in the source location.
 
-   .. image:: media/inter08.png
+.. image:: inter_warehouse/in-progress-internal-transfer.png
-      :align: center
-
-2. Select the right transfer order
-
-   .. image:: media/inter09.png
-      :align: center
-
-3. Click on the little pencil logo in the lower right
-corner in order to open the operation details window. In this new
-window you can manually indicate how much products you process
-
-.. image:: media/inter10.png
    :align: center
+   :alt: View of the dashboard with a zoom of the pending internal transfer.
 
-.. tip::
+- Select the right transfer order.
-   If you decide to partially process the transfer order (e.g. a part of the
+
-   products can't be shipped yet due to an unexpected event), Odoo will
+.. image:: inter_warehouse/internal-transfers-list.png
-   automatically ask if you wish to create a **backorder**.
+   :align: center
-   Create a backorder if you expect to process the remaining products
+   :alt: View of the pending internal transfers list.
-   later, do not create a backorder if you will not supply/receive the
+
-   remaining products.
+- Click on the little pencil logo in the lower right corner to open the operation details window.
+  In this new window you can manually indicate how many products you process.
+
+.. image:: inter_warehouse/backorder.png
+   :align: center
+   :alt: View of a backorder pop-up window because all products are not moved at the same time.
+
+.. note::
+   If you decide to process the transfer order partially (e.g., a part of the products can't be
+   shipped yet due to an unexpected event), Odoo automatically asks if you wish to create a
+   **backorder**.
+
+   - Create a backorder if you expect to process the remaining products later.
+   - Do not create a backorder if you will not supply/receive the remaining products.