hard/soft depr'n

Author: mikehoffms

microsoft-edge/extensions-chromium/developer-guide/run-compiled-code.md

@@ -1,45 +1,35 @@
 ---
-title: Run compiled code in your extension
-description: How to run compiled code in your extension.
+title: Run compiled code in an extension
+description: How to run compiled code in your extension at near-native speed, by using WebAssembly (Wasm).
 author: MSEdgeTeam
 ms.author: msedgedevrel
 ms.topic: conceptual
 ms.service: microsoft-edge
 ms.subservice: extensions
 ms.date: 02/06/2025
 ---
-# Run compiled code in your extension
+# Run compiled code in an extension
 
-<!-- todo: improve description: yaml field by summarizing article/ key words -->
+You can run compiled code in your extension at near-native speed, by using WebAssembly (Wasm).
 
-You can run compiled code in an extension at near-native speed.
-
-<!-- todo:
-With this new title, it would nice to add a generic intro about running compiled code in an extension.
-Why someone would want to do it? 
-What are the benefits.
-tell readers to use WebAssembly immediately, only keeping the NaCl deprecation notice for a sub-section of the article.
--->
+See:
+* [WebAssembly](https://developer.mozilla.org/docs/WebAssembly) at MDN.
+* [webassembly.org](https://webassembly.org/)
 
 
 <!-- ====================================================================== -->
 ## Native Client (NaCl) (deprecated)
 
-Native Client (NaCl) was a sandbox for running compiled C and C++ code in the browser efficiently and securely, independent of the user's operating system.
-
-To enhance web security and performance, NaCl is deprecated for Microsoft Edge, along with other browsers.   
-<!-- todo:
-which other browsers?
-link to deprecation notes from these other browsers
--->
+To enhance web security and performance, NaCl is deprecated for Microsoft Edge, along with other browsers.  NaCl was deprecated (discouraged but still supported) starting in 2020.  Support for NaCl will be discontinued starting with Microsoft Edge 138.
 
-<!-- todo: hard or soft deprection?  ie, will it still work, but discouraged?  or won't work now?  dates? -->
+Native Client (NaCl) was a sandbox for running compiled C and C++ code in the browser efficiently and securely, independent of the user's operating system.
 
-To run compiled code in your extension, we recommend using WebAssembly instead. WebAssembly, also known as Wasm, is a low-level assembly-like language which many other languages, such as C, C++, or Rust, can compile to, and which can run at near native-speed in web browsers.
+To Run compiled code in an extension, we recommend using WebAssembly instead of NaCl.  WebAssembly, also known as Wasm, is a low-level assembly-like language which many other languages, such as C, C++, or Rust, can compile to, and which can run at near native-speed in web browsers.
 
 See also:
 * [WebAssembly](https://developer.mozilla.org/docs/WebAssembly) at MDN.
 * [webassembly.org](https://webassembly.org/)
+* [Native Client](https://developer.chrome.com/docs/native-client) - deprecation notice for Chrome browser.<!-- todo: link to deprecation notices for other browsers -->
 
 
 <!-- ====================================================================== -->

microsoft-edge/extensions-chromium/whats-new/released-features.md

@@ -14,9 +14,6 @@ ms.date: 06/23/2023
 The following features or updates have been launched on [Partner Center](https://partner.microsoft.com/dashboard/microsoftedge/) for Microsoft Edge extensions.
 
 
-<!-- todo: deprecation of Native Client? -->
-
-
 <!-- ====================================================================== -->
 ## Sidebar
 

microsoft-edge/extensions-chromium/whats-new/roadmap.md

@@ -14,7 +14,14 @@ ms.date: 11/14/2024
 These are the next planned [Partner Center](https://partner.microsoft.com/dashboard/microsoftedge/) features or updates for Microsoft Edge extensions.
 
 
-<!-- todo: deprecation of Native Client? -->
+<!-- ====================================================================== -->
+## Deprecation of Native Client (NaCl)
+
+To enhance web security and performance, NaCl is deprecated for Microsoft Edge, along with other browsers.  Native Client (NaCl) was a sandbox for running compiled C and C++ code in the browser efficiently and securely, independent of the user's operating system.
+
+NaCl was deprecated (discouraged but still supported) starting in 2020.  Support for NaCl will be discontinued starting with Microsoft Edge 138.
+
+See [Native Client (NaCl) (deprecated)](../developer-guide/run-compiled-code.md#native-client-nacl-deprecated) in _Run compiled code in an extension_.
 
 
 <!-- ====================================================================== -->

microsoft-edge/toc.yml

@@ -1067,7 +1067,7 @@
             - name: Native messaging
               href: extensions-chromium/developer-guide/native-messaging.md
 
-            - name: Run compiled code in your extension
+            - name: Run compiled code in an extension
               href: extensions-chromium/developer-guide/run-compiled-code.md
 
             - name: Defining match patterns for an extension to access file URLs

microsoft-edge/web-platform/site-impacting-changes.md

@@ -30,7 +30,7 @@ Native Client (NaCl) was a sandbox for running compiled C and C++ code in the br
 
 The vibrant ecosystem around WebAssembly (Wasm) makes it a better fit for new and existing high-performance web apps. 
 
-See [Native Client (NaCl) (deprecated)](../extensions-chromium/developer-guide/run-compiled-code.md#native-client-nacl-deprecated) in _Run compiled code in your extension_.
+See [Native Client (NaCl) (deprecated)](../extensions-chromium/developer-guide/run-compiled-code.md#native-client-nacl-deprecated) in _Run compiled code in an extension_.
 
 
 <!-- ====================================================================== -->