From 62e2e4f62ea0e407e72e9bb04325a580d3cc7b06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Krier?= <ced@b2ck.com>
Date: Sat, 14 Sep 2024 12:39:28 +0200
Subject: [PATCH] Document viewing stock levels of lots

---
 modules/stock_lot/doc/index.rst |  1 +
 modules/stock_lot/doc/usage.rst | 39 +++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+)
 create mode 100644 modules/stock_lot/doc/usage.rst

diff --git a/modules/stock_lot/doc/index.rst b/modules/stock_lot/doc/index.rst
index 4b3bfb8dca..47f497b24a 100644
--- a/modules/stock_lot/doc/index.rst
+++ b/modules/stock_lot/doc/index.rst
@@ -10,5 +10,6 @@ of where the stock is and how much is available.
 .. toctree::
    :maxdepth: 2
 
+   usage
    design
    releases
diff --git a/modules/stock_lot/doc/usage.rst b/modules/stock_lot/doc/usage.rst
new file mode 100644
index 0000000000..11e32daddb
--- /dev/null
+++ b/modules/stock_lot/doc/usage.rst
@@ -0,0 +1,39 @@
+*****
+Usage
+*****
+
+The [:menuselection:`Inventory & Stock`] main menu item allows access to the
+items that allow you to view, manage and change things related to lots.
+
+.. _Viewing stock levels:
+
+Viewing stock levels
+====================
+
+Depending on what you are trying to find out you can get information about
+stock levels for either `Lots <model-stock.lot>` or `Locations
+<stock:model-stock.location>`.
+
+If you are interested in finding out where some particular lots are stored,
+then once you have selected the lots you are interested in, you can use the
+menu items in the lot's :guilabel:`Open related records` menu.
+
+To view how much lots is in one or more stock locations you first need to
+select the locations you are interested in.
+Once you have done this you can use the :guilabel:`Lots` itm from the
+:guilabel:`Open related records` menu.
+This then shows the total stock of each lot that is in all the selected locations.
+
+.. tip::
+
+   From the [:menuselection:`Inventory & Stock --> Locations`] main menu item
+   you can quickly get a list of lots in a single location by opening the
+   location you are interested in.
+
+.. tip::
+
+   If you have only selected a single location then the stock levels will
+   include all the stock in the location's children as well.
+   However, if you selected multiple locations then only the stock in the
+   selected locations is included, any stock in their child locations is
+   *not* included.