From 17f55cbd150d65a25da47efab3461ac7359aa60d Mon Sep 17 00:00:00 2001
From: DFINITYManu <123385598+DFINITYManu@users.noreply.github.com>
Date: Thu, 4 Sep 2025 11:46:40 +0200
Subject: [PATCH 1/2] Fix #2802 in grocy/grocy

https://github.com/grocy/grocy/issues/2802 fixed by this.
---
 tutorials/food.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/tutorials/food.md b/tutorials/food.md
index d2a4efa..6d98f9b 100644
--- a/tutorials/food.md
+++ b/tutorials/food.md
@@ -196,12 +196,14 @@ If you scanned an item that you have in stock, but with another brand, and you w
 
 ### Scan mode
 
-On top of the screen you can select **Scan mode off** or **Scan mode on**. The intention is to make it fast to purchase an item with a scanner. For scan mode to work as intended:
-- best before date must be filled with a default value or disabled in the config.
+On top of the screen you can select **Scan mode off** or **Scan mode on**. The goal of this feature is to make purchasing an item with a scanner as straightforward as possible. For scan mode to work as intended:
+- best before date of the product you scan must be filled with a default value or disabled in the config;
+- the setting *Default amount for purchase* (under *Stock settings*) must be set to a non-zero value;
+- the stock unit of the product you scan should be uniform rather than variable (think cans or bags, rather than grams or ounces).
 
-**Note:** Price will not be entered (if it is enabled)
+**Note:** Price will not be entered (if it is enabled) unless you entered it before scanning.
 
-When you purchase with scan mode it will purchase one of the purchase unit.
+When you purchase with scan mode it will purchase the default amount for purchase of the purchase unit.
 
 ## Consume
 

From 71dda19cfe2f82cbcac5ad8a2e8eb0bdf26fbf7c Mon Sep 17 00:00:00 2001
From: DFINITYManu <123385598+DFINITYManu@users.noreply.github.com>
Date: Thu, 4 Sep 2025 15:28:43 +0200
Subject: [PATCH 2/2] Update food.md per PR review.

---
 tutorials/food.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tutorials/food.md b/tutorials/food.md
index 6d98f9b..61508e4 100644
--- a/tutorials/food.md
+++ b/tutorials/food.md
@@ -201,9 +201,9 @@ On top of the screen you can select **Scan mode off** or **Scan mode on**. The g
 - the setting *Default amount for purchase* (under *Stock settings*) must be set to a non-zero value;
 - the stock unit of the product you scan should be uniform rather than variable (think cans or bags, rather than grams or ounces).
 
-**Note:** Price will not be entered (if it is enabled) unless you entered it before scanning.
+**Note:** Price (if it is enabled) will not be entered unless you enter it before scanning.
 
-When you purchase with scan mode it will purchase the default amount for purchase of the purchase unit.
+When you purchase with scan mode, if the barcode you scan contains an amount, the registered purchase will be for a number of items equal to that amount; if the barcode you scan does *not* contain an amount, then the purchase will be for a number of units equal to the *Default amount of purchase*.  E.g., if you scan a barcode of a product with purchase unit "cans" without an amount attached to it, and your *Default amount for purchase* is *2*, then the recorded purchase will be for *2 cans*.
 
 ## Consume