Update README.md

Author: Keillion

5.others/debug/README.md

@@ -4,39 +4,53 @@ This sample is designed to:
 
 1. Print detailed logs in the browser console to better assist in troubleshooting.
 2. Check if your device and browser are compatible with the camera and to what extent.
-3. Collect video frames for analysis.
+3. Collect video frames for analysis. (Require to host the sample locally)
 
-*Quick Debug*: [https://dynamsoft.github.io/barcode-reader-javascript-samples/5.others/debug/public/index.html](https://dynamsoft.github.io/barcode-reader-javascript-samples/5.others/debug/public/index.html)
+You can directly debug 1 and 2 in this link: [https://dynamsoft.github.io/barcode-reader-javascript-samples/5.others/debug/public/index.html](https://dynamsoft.github.io/barcode-reader-javascript-samples/5.others/debug/public/index.html)
+
+Item 3 we will introduce in detail.
 
 ## Collect the video frames for analysis
 
-When you encounter unreadable barcodes via a video input, you can use this sample to take a few sample frames to share with the Dynamsoft Support Team for debugging purposes.
+Barcode reading is a one-time job, the application either succeeds or fails to read the barcode(s). For the failed cases, it's possible to make them successful by adjusting some of the many settings provided by the Dynamsoft Barcode Reader JavaScript SDK (hereafter called "the library"). However, adjusting the settings could be a bit overwhelming for the users. Therefore, Dynamsoft provides this debug sample which allows a user to collect runtime video frames to be sent to the Dynamsoft Team. Since these frames represent the actual usage scenario, the team can test them to see how the settings can be optimized to best process them.
+
+The following shows how to host the sample and collect frames.
+
+### Download the sample
+
+The sample can be downloaded from
 
-Since the video is usually playing on mobile devices, having these frames uploaded to a self-hosted local server is most convenient, the following shows how to use the sample.
+<a target_="blank" href="https://github.com/Dynamsoft/barcode-reader-javascript-samples/tree/main/5.others/debug" alt="Debug Sample on GitHub">Debug Sample on GitHub</a>
+
+Note that the entire folder is required. To download only the files in this folder, try using "https://downgit.github.io/#/home".
 
 ### Set up a local server
 
+Since the video is usually playing on mobile devices, having these frames uploaded to a self-hosted local server is most convenient, therefore, we first need to set up a local server.
+
 We make use of the web server that comes with [Express](https://expressjs.com/).
 
-### Install Express
+* Install dependencies
 
-Run the following script to install Express.
+Run the following script to install all dependencies.
 
 `npm install`
 
-### Start the server
+* Start the server
 
 We defined the web server logic in the file "app.js", to start it, run the following script:
 
 `node app.js`
 
-Note that we have enabled SSL on this server at the port 4443.
+Note that we have used self-signed certificates to enable SSL on the port 4443.
 
 ### Use the sample page
 
 Once the server is up and running, open the page on the device that will do the barcode reading. The URL for the sample is "https://{your-local-ip}:4443/". For example, suppose your ip is 192.168.1.1, the site can be visited at [https://192.168.1.1:4443/](https://192.168.1.1:4443/).
 
-> Note that the device should be in the same WiFi network as the server machine.
+> Note that the device should be in the same WiFi network as the server machine. 
+
+You will see a warning when you visit the page. This is caused by self-signing. Ignore and keep processing.
 
 Click the button "show scanner" and try to read barcodes as you normally do, the frames will then be uploaded to the folder "debug\public\collect" as images (.png) on the server. When you have collected enough frames, don't forget to turn off the scanner, otherwise, new frames will continue to flood in.