Repository: dotnet/runtime
File: src/libraries/System.Net.WebProxy/src/System/Net/IWebProxyScript.cs (C#)

Code before:
        /// <summary>
        /// Closes a script.
        /// </summary>
        void Close();

        /// <summary>
        /// Loads a script.
        /// </summary>
        /// <param name="scriptLocation">Internal only.</param>
        /// <param name="script">Internal only.</param>
        /// <param name="helperType">Internal only.</param>
        /// <returns>A <see cref="bool"/> indicating whether the script was successfully loaded.</returns>
        bool Load(Uri scriptLocation, string script, Type helperType);

        /// <summary>
        /// Runs a script.
        /// </summary>
        /// <param name="url">Internal only.</param>
        /// <param name="host">Internal only.</param>
        /// <returns>
        /// A <see cref="string"/>.
        /// An internal-only value returned.
        /// </returns>
        /// <remarks>
        /// <para>
        /// When the <c>HttpWebRequest</c> object is run, it may need to run the WPAD (Web Proxy Automatic Detection) protocol to detect whether a proxy is required for reaching the destination URL.
        /// During this process, the system downloads and compiles the PAC (Proxy Auto-Configuration) script in memory and tries to execute the FindProxyForURL function as per the PAC specification.
        /// </para>
        /// <para>
        /// When doing so, the system creates an internal application domain inside the application which runs with minimal permissions, and, most importantly, it does not grant the UI permission to this new application domain.
        /// The evaluation of a proxy and running the FindProxyForURL javascript function happens in the context of this new application domain and during this process the system may need to run several helper functions as per the PAC specification.
        /// </para>
        /// </remarks>
        string Run(string url, string host);
    }
}


Review comment (suggestion):
```suggestion
        /// When the <c>HttpWebRequest</c> object is run, it might need to run the WPAD (Web Proxy Automatic Detection) protocol to detect whether a proxy is required for reaching the destination URL.
```

Code after:
        /// <summary>
        /// Closes a script.
        /// </summary>
        void Close();

        /// <summary>
        /// Loads a script.
        /// </summary>
        /// <param name="scriptLocation">The URI that identifies the location of the proxy auto-configuration script.</param>
        /// <param name="script">The script content to load and prepare for execution.</param>
        /// <param name="helperType">The type that provides helper methods or services available to the script at runtime.</param>
        /// <returns>A <see cref="bool"/> indicating whether the script was successfully loaded.</returns>
        bool Load(Uri scriptLocation, string script, Type helperType);

        /// <summary>
        /// Runs a script.
        /// </summary>
        /// <param name="url">The destination URL for which proxy information is requested.</param>
        /// <param name="host">The host name associated with the destination URL.</param>
        /// <returns>
        /// A <see cref="string"/> that describes how to connect to the destination, such as a proxy configuration directive (for example, <c>"DIRECT"</c> or <c>"PROXY host:port"</c>).
        /// </returns>
        string Run(string url, string host);
    }
}