rename property name and doc improvements

Author: GittyHarsha

specs/EnhancedSecurityMode.md specs/IsEnhancedSecurityModeEnabled.mdspecs/EnhancedSecurityMode.md renamed to specs/IsEnhancedSecurityModeEnabled.md

@@ -1,45 +1,60 @@
-EnhancedSecurityMode
+IsEnhancedSecurityModeEnabled
 ===
 
 # Background
 
-Enhanced Security Mode (ESM) is a Microsoft Edge security feature that reduces the risk of memory-related vulnerabilities by disabling JavaScript Just-in-Time (JIT) compilation and enabling additional operating system protections.
+Enhanced Security Mode (ESM) is a Microsoft Edge security feature that reduces 
+the risk of memory-related vulnerabilities by disabling JavaScript Just-in-Time 
+(JIT) compilation and enabling additional operating system protections.
 
-In WebView2, ESM is off by default to avoid performance impact. Host applications can enable ESM for stricter security when rendering untrusted or sensitive content. While this improves security, it may reduce JavaScript performance.
+In WebView2, ESM is off by default to avoid performance impact. You can enable 
+ESM for stricter security when rendering untrusted sites. While this improves
+security, it may reduce JavaScript performance.
 
 In Microsoft Edge, ESM offers two levels:
 
-- Balanced – Enabled only for unfamiliar sites based on browser usage patterns.
-- Strict – Always enabled for all sites.
+- Balanced – Enhanced security is used for unfamiliar sites based on browser usage patterns.
+- Strict – Enhanced security is used for all sites.
 
 ![image](https://github.com/MicrosoftEdge/WebView2Feedback/assets/82386753/35977716-e46c-4257-82da-906b0c6f833e)
 
-Unlike Edge browser, WebView2 does not support heuristic-based "Balanced" level. Only two options are available: Off and Strict.
+Unlike Microsoft Edge, WebView2 does not support the heuristic-based "Balanced" 
+level; only Off and Strict are available.
 
-Currently, ESM level can only be configured via the `--sdsm-state` browser flag([see for more details](https://learn.microsoft.com/en-us/microsoft-edge/webview2/concepts/webview-features-flags?tabs=dotnetcsharp)) at environment creation, applying globally to all profiles. There is no flexibility to modify the level at runtime.
+Today, the ESM level in WebView2 can be set only at environment creation by using
+the `--sdsm-state` browser feature flag ([webview2 browser flag docs](https://learn.microsoft.com/en-us/microsoft-edge/webview2/concepts/webview-features-flags?tabs=dotnetcsharp)). 
+The setting applies globally to all profiles and cannot be changed at runtime.
 
-This proposal introduces an API to enable or disable ESM and persist the configuration for a WebView2 profile within the user data folder.
+This proposal introduces an API to enable or disable ESM and persist the configuration 
+for a WebView2 profile within the user data folder.
 
-## CoreWebView2Profile.EnhancedSecurityMode
-Enables or disables Enhanced Security Mode (ESM) for all WebView2 instances sharing the same profile. This property value is persisted for a WebView2 profile in the user data folder. The default value is false.
+## CoreWebView2Profile.IsEnhancedSecurityModeEnabled
+Enables or disables Enhanced Security Mode (ESM) for all WebView2 instances 
+sharing the same profile. This property value is persisted for a WebView2 
+profile in the user data folder. The default value is false.
 
-- true: ESM enabled in Strict level: disables JavaScript JIT and applies additional OS protections.
+- true: ESM enabled in Strict level: Enhanced security is used for all sites.
 - false: ESM level is Off.
 
-Changes apply to future navigations; reload may be required. Enabling ESM improves security but can reduce JavaScript performance.
+> Changes apply to future navigations; reload may be required.
 
 # Examples
 
-## EnhancedSecurityMode
+## IsEnhancedSecurityModeEnabled
 
 Enable Enhanced Security Mode for a profile.
 
 ```c#
 void EnableEnhancedSecurityMode()
 {
     var profile = webView2.CoreWebView2.Profile;
-    profile.EnhancedSecurityMode = true;
-    MessageBox.Show(this, "Enhanced security mode is enabled", "Enhanced Security Mode");
+    if (!profile.IsEnhancedSecurityModeEnabled)
+    {
+        profile.IsEnhancedSecurityModeEnabled = true;
+        MessageBox.Show(this,
+            "Enhanced Security Mode (Strict) enabled for this profile. Reload pages to apply.",
+            "Enhanced Security Mode");
+    }
 }
 ```
 
@@ -57,9 +72,9 @@ void EnableEnhancedSecurityMode()
         auto profile12 = profile.try_query<ICoreWebView2Profile12>();
         if (profile12)
         {
-            CHECK_FAILURE(profile12->put_EnhancedSecurityMode(TRUE));
-            MessageBox(
-                nullptr, L"Enhanced security mode is enabled",
+            CHECK_FAILURE(profile12->put_IsEnhancedSecurityModeEnabled(TRUE));
+            MessageBox(nullptr,
+                L"Enhanced Security Mode (Strict) enabled. Reload pages to apply.",
                 L"Enhanced Security Mode", MB_OK);
         }
     }
@@ -91,11 +106,11 @@ void EnableEnhancedSecurityMode()
 [uuid(d5b781db-0a75-5f9c-85b1-40fa814fcea7), object, pointer_default(unique)]
 interface ICoreWebView2Profile12 : IUnknown {
   /// Gets whether Enhanced Security Mode is enabled for this profile.
-  [propget] HRESULT EnhancedSecurityMode([out, retval] BOOL* value);
+  [propget] HRESULT IsEnhancedSecurityModeEnabled([out, retval] BOOL* value);
 
   /// Enables or disables Enhanced Security Mode for this profile.
   /// See notes above for behavior and performance impact.
-  [propput] HRESULT EnhancedSecurityMode([in] BOOL value);
+  [propput] HRESULT IsEnhancedSecurityModeEnabled([in] BOOL value);
 }
 ```
 
@@ -108,7 +123,7 @@ namespace Microsoft.Web.WebView2.Core
         [interface_name("Microsoft.Web.WebView2.Core.ICoreWebView2Profile12")]
         {
             // ICoreWebView2Profile12 members
-            Boolean EnhancedSecurityMode { get; set; };
+            Boolean IsEnhancedSecurityModeEnabled { get; set; };
         }
     }
 }