From ecf2cc504a0ed4517965fe2f4aa16be4adad307c Mon Sep 17 00:00:00 2001
From: lyzhang0113 <github@doby2333.com>
Date: Mon, 3 Aug 2026 13:48:35 +0800
Subject: [PATCH 1/2] Fix debug-mode FAQ heading structure and broken image
 reference

Add a missing H1, rephrase the changelog-style H2 into an actionable
"Enable debug mode" section, and rename the undefined.png asset to
upload-template.png to match its actual content.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .../assets/{undefined.png => upload-template.png}   | Bin
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename barcode-reader/web/assets/{undefined.png => upload-template.png} (100%)

diff --git a/barcode-reader/web/assets/undefined.png b/barcode-reader/web/assets/upload-template.png
similarity index 100%
rename from barcode-reader/web/assets/undefined.png
rename to barcode-reader/web/assets/upload-template.png

From 084a2a4c8daea909dbb03806eb7cec7fc891b5bd Mon Sep 17 00:00:00 2001
From: lyzhang0113 <github@doby2333.com>
Date: Mon, 3 Aug 2026 13:49:08 +0800
Subject: [PATCH 2/2] Update debug-mode.md image reference to renamed asset

Follow-up to the previous commit: the markdown edit referencing
upload-template.png wasn't staged in that commit.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 barcode-reader/web/debug/debug-mode.md | 26 ++++++++++----------------
 1 file changed, 10 insertions(+), 16 deletions(-)

diff --git a/barcode-reader/web/debug/debug-mode.md b/barcode-reader/web/debug/debug-mode.md
index 3b5e27d..b71a869 100644
--- a/barcode-reader/web/debug/debug-mode.md
+++ b/barcode-reader/web/debug/debug-mode.md
@@ -6,9 +6,15 @@ description: Enable debug mode, upload custom JSON templates, save video frames,
 needAutoGenerateSidebar: false
 ---
 
-## What's new in version v11.0.3000?
+# How to enable and use debug mode in DBR-JS?
+
+## Enable debug mode
+
+Starting from v11.0.3000, you can enable the demo's debug mode by appending `?debug=true` to the demo URL, for example:  
+https://demo.dynamsoft.com/barcode-reader-js/?debug=true
+
+This version also adds:
 
-- Support for debug mode using `?debug=true`
 - Custom template upload feature
 - Video frame saving during debugging
 - Improved UI with:
@@ -18,20 +24,8 @@ needAutoGenerateSidebar: false
 
 ---
 
-## Enable debug mode
-
-Append `?debug=true` to the demo URL.  
-Example: https://demo.dynamsoft.com/barcode-reader-js/?debug=true
-
-In debug mode:
-
-- You can upload **custom templates** compatible with v11.0.3000
-- You can **save video frames**
-
----
-
 <div align="left">
-    <p><img src="{{site.dbr_web_assets}}undefined.png" width="40%" alt="advanced settings"></p>
+    <p><img src="{{site.dbr_web_assets}}upload-template.png" width="40%" alt="advanced settings"></p>
 </div>
 
 ## Upload a custom template
@@ -46,7 +40,7 @@ In debug mode:
 
 ## Save video frames
 
-Yes — in **debug mode**, you can save video frames for testing and analysis (top-right of the UI).
+In debug mode, you can save video frames for testing and analysis using the button in the top-right of the UI.
 
 ---