Update IsSmartScreenRequired.md

Author: lamryQAQ-2nd

specs/IsSmartScreenRequired.md

@@ -2,22 +2,22 @@
 
 [Edge SmartScreen](https://support.microsoft.com/en-us/microsoft-edge/how-can-smartscreen-help-protect-me-in-microsoft-edge-1c9a874a-6826-be5e-45b1-67fa445a74c8) helps end users identify reported phishing and malware websites, and also helps end users make informed decisions about downloads.
 
-Currently, developers can use `options->put_AdditionalBrowserArguments(L"--disable-features=msSmartScreenProtection")` to disable SmartScreen in the WebView2 application. It is a startup parameter of the browser process and applies to all WebView2 instances associated with that WebView2Environment. It must be determined when the WebView2Environment is created, and it cannot be modified at runtime.
+Currently, developers can use `options->put_AdditionalBrowserArguments(L"--disable-features=msSmartScreenProtection")` to disable SmartScreen in the WebView2 application. It is a startup parameter of the browser process and applies to all WebView2 instances using the same user data folder. It must be determined when the WebView2Environment is created, and it cannot be modified at runtime.
 
 To support more flexibility we introduce a new API.
 
-we have CoreWebView2Settings.IsSmartScreenRequired. Each WebView2 declares if it requires SmartScreen. Some WebView2s may be used to display app content and don't require SmartScreen and others may be rendering arbitrary web content and do need SmartScreen. Having SmartScreen on unnecessarily for app content is a detriment to performance but otherwise not a problem. Having SmartScreen off for arbitrary web content is an issue. We have to turn SmartScreen on or off for all the WebView2s in an environment so if any WebView2 requires SmartScreen then we turn it on for all of them. If WebView2 settings change or WebView2s are closed and then all the WebView2s in an environment don't require SmartScreen, then we can turn SmartScreen off.
+We have CoreWebView2Settings.IsReputationCheckingRequired. Each WebView2 declares if it requires SmartScreen. Some WebView2s may be used to display app content and don't require SmartScreen and others may be rendering arbitrary web content and do need SmartScreen. Having SmartScreen on unnecessarily for app content is a detriment to performance but otherwise not a problem. Having SmartScreen off for arbitrary web content is an issue. We have to turn SmartScreen on or off for all WebView2 using the same user data folder so if any WebView2 requires SmartScreen then we turn it on for all of them. If WebView2 settings change or WebView2s are closed and then all WebView2s using the same user data folder don't require SmartScreen, then we can turn SmartScreen off.
 
 It is much easier to indicate if individual WebView2s require SmartScreen than to have an end developer explicitly manage if SmartScreen should be enabled as a whole, especially when its different sets of WebView2s in different processes (like Excel's set of WebView2s and Word's set of WebView2s) all sharing the same user data folder.
 In this document we describe the new setting.
 
 
 # Description
-You can use CoreWebView2Settings.IsSmartScreenRequired to control SmartScreen. SmartScreen is enabled or disabled per browser process, so all WebView2 applications sharing the same user data folder path also share SmartScreen being enabled or disabled.
-If CoreWebView2Setting.IsSmartScreenRequired is true for any CoreWebView2 in its associated CoreWebView2Environment, then SmartScreen is enabled. If CoreWebView2Setting.IsSmartScreenRequired is false for all CoreWebView2s in their CoreWebView2Environment, then SmartScreen is disabled.
-The default value for `IsSmartScreenRequired` is true. When a new WebView is created, the SmartScreen state under the same CoreWebView2Environment will be reset to true.
+You can use CoreWebView2Settings.IsReputationCheckingRequired to control SmartScreen. SmartScreen is enabled or disabled per browser process, so all WebView2 applications sharing the same user data folder path also share SmartScreen being enabled or disabled.
+If CoreWebView2Setting.IsReputationCheckingRequired is true for any CoreWebView2 using the same user data folder, then SmartScreen is enabled. If CoreWebView2Setting.IsReputationCheckingRequired is false for all CoreWebView2 using the same user data folder, then SmartScreen is disabled.
+The default value for `IsReputationCheckingRequired` is true. When a new CoreWebview2 is created, the SmartScreens of all CoreWebviews using the same user data folder are reset to true.
 
-Changes to `IsSmartScreenRequired` take effect on the next navigation or download.
+Changes to `IsReputationCheckingRequired` take effect on the next navigation or download.
 
 
 # Examples
@@ -35,7 +35,7 @@ void SettingsComponent::UpdateSmartScreenRequirementBeforeNavigating(bool isLoca
                 m_webViewSettings.try_query<ICoreWebView2Settings11>();
     if(coreWebView2Settings11) 
     {
-        CHECK_FAILURE(coreWebView2Settings11->put_IsSmartScreenRequired(!isLocalContent));
+        CHECK_FAILURE(coreWebView2Settings11->put_IsReputationCheckingRequired(!isLocalContent));
     }
 }
 ```
@@ -44,7 +44,7 @@ void SettingsComponent::UpdateSmartScreenRequirementBeforeNavigating(bool isLoca
 void ToggleSmartScreenRequired()
 {
     var settings = webView2Control.CoreWebView2.Settings;
-    settings.IsSmartScreenRequired = !settings.IsSmartScreenRequired;
+    settings.IsReputationCheckingRequired = !settings.IsReputationCheckingRequired;
 }
 ```
 
@@ -62,20 +62,20 @@ See [API Details](#api-details) section below for API reference.
 interface ICoreWebView2Settings11 : ICoreWebView2Settings10 {
   /// SmartScreen helps webviews identify reported phishing and malware websites and 
   /// also helps users make informed decisions about downloads.
-  /// `IsSmartScreenRequired`  is used to control whether SmartScreen enabled or not. 
-  /// SmartScreen is enabled or disabled for all CoreWebView2s in a CoreWebView2Environment. 
-  /// If CoreWebView2Setting.IsSmartScreenRequired is true for any CoreWebView2 associated to the same
-  /// CoreWebView2Environment, then SmartScreen is enabled. If CoreWebView2Setting.IsSmartScreenRequired 
-  /// is false for all CoreWebView2s in the associated CoreWebView2Environment, then SmartScreen is disabled.
+  /// `IsReputationCheckingRequired`  is used to control whether SmartScreen enabled or not. 
+  /// SmartScreen is enabled or disabled for all CoreWebView2s using the same user data folder. 
+  /// If CoreWebView2Setting.IsReputationCheckingRequired is true for any CoreWebView2 using the same 
+  /// user data folder, then SmartScreen is enabled. If CoreWebView2Setting.IsReputationCheckingRequired 
+  /// is false for all CoreWebView2 using the same user data folder, then SmartScreen is disabled.
   /// When it is changed, the change will be applied to all WebViews using the 
-  /// same CoreWebView2Environment on the next navigation or download.
-  /// The default value for `IsSmartScreenRequired` is true. When a new WebView is created, the SmartScreen 
-  /// state under the same CoreWebView2Environment will be reset to true.
-  [propget] HRESULT IsSmartScreenRequired([out, retval] BOOL* value); 
+  /// same user data folder on the next navigation or download.
+  /// The default value for `IsReputationCheckingRequired` is true. When a new CoreWebview2 
+  /// is created, the SmartScreens of all CoreWebviews using the same user data folder are reset to true.
+  [propget] HRESULT IsReputationCheckingRequired([out, retval] BOOL* value); 
 
   /// Sets whether this webview2 instance needs SmartScreen protection for its content.
-  /// Set the `IsSmartScreenRequired` property. 
-  [propput] HRESULT IsSmartScreenRequired([in] BOOL value); 
+  /// Set the `IsReputationCheckingRequired` property. 
+  [propput] HRESULT IsReputationCheckingRequired([in] BOOL value); 
 }
 ```
 
@@ -87,12 +87,12 @@ namespace Microsoft.Web.WebView2.Core
         // ...
         [interface_name("Microsoft.Web.WebView2.Core.ICoreWebView2Settings11")]
         {
-            Boolean IsSmartScreenRequired { get; set; };
+            Boolean IsReputationCheckingRequired { get; set; };
         }
     }
 }
 ```
 
 # Appendix
 
-We initially considered an API like `CoreWebView2Environment.IsSmartScreenEnabled` that would directly change the value for all the processes. The problem is this is not easy to do for apps like Office who have multiple apps connected to the same browser process. In their case each app has IsSmartScreenEnabled and its hard for the browser process to know which change to the property should win. 
+We initially considered an API like `CoreWebView2Environment.IsReputationCheckingRequired` that would directly change the value for all the processes. The problem is this is not easy to do for apps like Office who have multiple apps connected to the same browser process. In their case each app has IsReputationCheckingRequiredxf and its hard for the browser process to know which change to the property should win.