Clean up release notes: fix link, consistent headings, add 'why' to API shift notice, reposition BarcodeScanner sections

Author: Tom-Dynamsoft

programming/javascript/release-notes/js-11.md

@@ -21,6 +21,12 @@ Starting with this release, the **Foundational API** (`CaptureVisionRouter` and
 - **v11 (current)** – No breaking changes. `BarcodeScanner` continues to work exactly as before and will receive maintenance updates and bug fixes for the entire v11 lifecycle.
 - **v12 (future)** – `BarcodeScanner` will no longer be bundled as part of the main `dynamsoft-barcode-reader-bundle` package. It will be distributed separately.
 
+**Why this change:**
+
+- **Foundational scales; the wrapper doesn't.** When projects move beyond basic demos — adding custom scan UIs, integrating other DCV components (document detection, label recognition), or building production workflows — `BarcodeScanner` hits a wall. Developers end up rebuilding on the Foundational API anyway.
+- **One clear path, not two.** Two parallel API surfaces create confusion at evaluation time — for developers and for the AI coding assistants they increasingly use. A single recommended path simplifies onboarding.
+- **AI tools close the boilerplate gap.** Much of `BarcodeScanner`'s value was fewer lines of code. With AI-assisted coding now common, developers can scaffold Foundational API code just as quickly.
+
 **Recommended action for new projects:** Build on the Foundational API to ensure forward compatibility. See the [Foundational API Guide](../user-guide/index.html) for a full walkthrough.
 
 **Existing projects using `BarcodeScanner`:** No action required for v11. When v12 is released, a migration guide will be provided.