From dd5baea23a987022b12247c73693ee4acce52bcb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Krier?= <ced@b2ck.com>
Date: Tue, 21 Oct 2025 13:35:04 +0200
Subject: [PATCH] Document the scheduled task to assign shipments and
 productions

---
 modules/production/doc/index.rst         |  1 +
 modules/production/doc/usage.rst         | 19 +++++++++++++++++++
 modules/stock/doc/usage/shipment.inc.rst |  6 ++++++
 3 files changed, 26 insertions(+)
 create mode 100644 modules/production/doc/usage.rst

diff --git a/modules/production/doc/index.rst b/modules/production/doc/index.rst
index ba8f245f0d..4d44de3be3 100644
--- a/modules/production/doc/index.rst
+++ b/modules/production/doc/index.rst
@@ -9,5 +9,6 @@ This includes definition for bill of material and production orders.
 .. toctree::
    :maxdepth: 2
 
+   usage
    design
    releases
diff --git a/modules/production/doc/usage.rst b/modules/production/doc/usage.rst
new file mode 100644
index 0000000000..8aacb4d93a
--- /dev/null
+++ b/modules/production/doc/usage.rst
@@ -0,0 +1,19 @@
+*****
+Usage
+*****
+
+.. _Assigning productions:
+
+Assigning productions
+=====================
+
+The `Productions <model-production>` take stock from storage `Locations
+<stock:model-stock.location>` inside the `Warehouse
+<stock:concept-stock.location.warehouse>`.
+The :guilabel:`Input Materials` must be assigned before they can be done like
+:ref:`Shipment <stock:Assigning shipments>`.
+
+.. note::
+
+   The `Scheduled tasks <trytond:model-ir.cron>` :guilabel:`Assign Shipments`
+   tries also to assign waiting productions planned for today.
diff --git a/modules/stock/doc/usage/shipment.inc.rst b/modules/stock/doc/usage/shipment.inc.rst
index 3813fd8472..00fb8ec38a 100644
--- a/modules/stock/doc/usage/shipment.inc.rst
+++ b/modules/stock/doc/usage/shipment.inc.rst
@@ -123,3 +123,9 @@ locations having negative stock.
    taken from one of its sub-locations, as view locations cannot be the
    source or destination of a done move.
    This also means moves from a view location cannot be forced.
+
+.. note::
+
+   You may want to define some `Scheduled tasks <trytond:model-ir.cron>`
+   :guilabel:`Assign Shipments` to try to assign automatically waiting
+   shipments due today.