Restructure user guide to prioritize BarcodeScanner API

- Rename barcode-scanner.md to index.md (now the default entry point)
- Rename index.md to foundational-api.md (advanced use cases)
- Update all internal links to reflect new file structure
- Add prominent banner to foundational API guide redirecting most users to BarcodeScanner
- Add AI-friendly metadata for better documentation assistance
- Update metadata/titles to reflect guide purposes

Author: Tom-Dynamsoft

_includes/samples_index.html

@@ -1049,7 +1049,7 @@
           <span
             class="guide-badge"
             title="View user guide documentation"
-            onclick="event.stopPropagation(); window.open('https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/barcode-scanner.html', '_blank'); return false;"
+            onclick="event.stopPropagation(); window.open('https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/index.html', '_blank'); return false;"
           >
             <svg width="20" height="20" viewBox="0 0 16 16" fill="white">
               <path

_includes/sidelist-programming/programming-javascript.html

@@ -7,7 +7,7 @@
   <ul lang="javascript">
     <li lang="javascript">
         <a
-          href="{{ site.js }}user-guide/barcode-scanner.html"
+          href="{{ site.js }}user-guide/index.html"
           style="cursor: pointer; color: #3c3c3c"
           >Start with RTU-BarcodeScanner</a
         >
@@ -27,7 +27,7 @@
       <ul lang="javascript">
         <li lang="javascript">
           <a
-            href="{{ site.js }}user-guide/index.html"
+            href="{{ site.js }}user-guide/foundational-api.html"
             style="cursor: pointer; color: #3c3c3c"
             >Get Started</a
           >

programming/javascript/index.md

@@ -18,7 +18,7 @@ Dynamsoft Barcode Reader (DBR) can be used in JavaScript to add barcode reading
 
 To get a fast start, you can
 
-- read the [User Guide](user-guide/barcode-scanner.html), or
+- read the [User Guide](user-guide/index.html), or
 - try the [Samples and Demos](samples-demos/)
 
 The following describes the highlights of DBR JavaScript edition (DBR-JS) version 11.x.
@@ -36,7 +36,7 @@ With `BarcodeScanner`, you can:
 - Focus on your application logic without worrying about camera setup, UI rendering, or lifecycle management.
 
 > [!TIP]
-> You can either get a [quick start with the BarcodeScanner APIs](user-guide/barcode-scanner.html) or experience a highly customizable [development with the foundational APIs](user-guide/index.html). If you're just starting out, we highly recommend using the `BarcodeScanner` class for the best balance of simplicity, performance, and user experience.
+> You can either get a [quick start with the BarcodeScanner APIs](user-guide/index.html) or experience a highly customizable [development with the foundational APIs](user-guide/foundational-api.html). If you're just starting out, we highly recommend using the `BarcodeScanner` class for the best balance of simplicity, performance, and user experience.
 
 ---
 
@@ -92,7 +92,7 @@ DBR-JS v11.x is based on [Dynamsoft Capture Vision]({{site.dcvb_architecture}})
 
 ## Next Step
 
-Read the [User Guide](user-guide/barcode-scanner.html) to start building your own websites with barcode reading capabilities.
+Read the [User Guide](user-guide/index.html) to start building your own websites with barcode reading capabilities.
 
 ## See Also
 

programming/javascript/upgrade-guide/10to11.md

@@ -72,4 +72,4 @@ The Dynamsoft Barcode Reader JavaScript edition has been refactored to integrate
 > 
 > Dynamsoft's ongoing feature development is based on the new DCV architecture. By upgrading to v11, you'll gain access to improved performance and new capabilities.
 
-Due to the architectural changes, **a significant rewrite of your existing code is required**. we recommend you to follow the [User Guide](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/barcode-scanner.html) and re-write your codes.
+Due to the architectural changes, **a significant rewrite of your existing code is required**. we recommend you to follow the [User Guide](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/index.html) and re-write your codes.

programming/javascript/user-guide/barcode-scanner.md

@@ -14,7 +14,7 @@ permalink: /programming/javascript/user-guide/explore-features/index.html
 
 Once you have got an application running with Dynamsoft Barcode Reader JavaScript edition, you can explore the many features of the SDK to see how to make the best out of the SDK.
 
-> If you are just getting started with Dynamsoft Barcode Reader JavaScript Edition, we recommend that you read [Get Started](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/index.html) first.
+> If you are just getting started with Dynamsoft Barcode Reader JavaScript Edition, we recommend that you read the [BarcodeScanner User Guide](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/index.html) first.
 
 ## Basic Features