Add advanced proxy settings article.

README.md

@@ -1,7 +1,7 @@
 <h1>
 <a name="fiddler-core-public-documentation" class="anchor" href="#fiddler-core-public-documentation"><span class="mini-icon mini-icon-link"></span></a>FiddlerCore Public Documentation</h1>
 
-<p>Welcome to the GitHub repo for <a href="http://www.telerik.com/fiddler/fiddlercore">FiddlerCore</a> <a href="https://docs.telerik.com/fiddler-core">Documentation</a>. This repository contains the source content--written in Markdown--that we use to power the FiddlerCore. 
+<p>Welcome to the GitHub repo for <a href="http://www.telerik.com/fiddler/fiddlercore">FiddlerCore</a> <a href="https://docs.telerik.com/fiddler-core">Documentation</a>. This repository contains the source content--written in Markdown--that we use to power the FiddlerCore documentation. 
 
 <p>We believe that the documentation for a product is at its best when the content is a collaboration between the builders and consumers of that product. As such, this documentation is both public, and open sourced. That means you can clone this repository, read the docs off line, or even load the entire thing to an Apple Newton, if that's your thing.</p>
 

basic-usage/capture-https-traffic.md

@@ -8,40 +8,44 @@ position: 3
 
 # Capture HTTP/S Traffic with FiddlerCore
 
-This article expains how to capture HTTP/S traffic with FiddlerCore
+This article explains how to capture HTTP/S traffic with FiddlerCore
 
 Once FiddlerCore is [configured]({%slug configuration %}), it starts to listen for a traffic on the background. When it captures any session, it notifies you by raising the following events:
 
->It is important to understand that FiddlerCore calls event handlers on session-handling background threads.
+>The following event handlers are invoked on session-handling **background threads**. 
+>
+>If you need to need to update a UI thread (e.g. in WPF or Windows Forms application), you may need to delegate the update logic back to the UI thread, for example by using [Dispatcher.BeginInvoke](https://docs.microsoft.com/en-us/dotnet/api/system.windows.threading.dispatcher.begininvoke) (WPF) or [Control.Invoke](https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.control.invoke) (Windows Forms).
+>
+>Also, if you use collections that are not thread-safe, like [`List<T>`](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1), you may need to employ additional synchronization mechanisms.
 
 ## FiddlerApplication.BeforeRequest
 You should use this event to act when client request is received. For example, you can modify the session flags to use specific ssl protocols.
-
-    Fiddler.FiddlerApplication.BeforeRequest += session => 
+```c#
+    FiddlerApplication.BeforeRequest += session => 
     {
         session["x-OverrideSslProtocols"] = "ssl3;tls1.0;tls1.1;tls1.2";
     };
-
+```
 
 ## FiddlerApplication.BeforeResponse
 
-You should use this event to act when a server responce is received. For example, you can decode the body.
-
-    Fiddler.FiddlerApplication.BeforeResponse += session => 
+You should use this event to act when a server response is received. For example, you can decode the body.
+```c#
+    FiddlerApplication.BeforeResponse += session => 
     {
         session.utilDecodeResponse(); 
     };
-
+```
 ## FiddlerApplication.AfterSessionComplete
 
 You should use this event to act when a session is completed. For example, notify the user.
-
+```c#
     FiddlerApplication.AfterSessionComplete += session => 
     {
         Console.WriteLine($"Finished session: {session.fullUrl}");
     }
-
->tip These are only the most commonly used handlers. For the full list of events check [this article](/api/fiddler.fiddlerapplication)
+```
+>tip These are only the most commonly used handlers. For the full list of events check [FiddlerApplication's API reference](/api/fiddler.fiddlerapplication).
 
 ## Next Steps
 

basic-usage/configuration.md

@@ -86,6 +86,14 @@ FiddlerApplication.Prefs.SetStringPref("fiddler.proxy.pacfile.text", "return 'PR
 - `DecryptSSL()`:  Enables decryption of HTTPS traffic. You should have a CertificateProvider loaded with trusted certificate. For more details see [Use Custom Root Certificate]({%slug use-custom-root-certificate %}) article.
 - `OptimizeThreadPool()`: Optimizes the thread pool to better handle multiple simultaneous threads. This is often convenient, as each `Session` is handled in a different thread. Under the hood, this methods uses [`ThreadPool.SetMinThreads`](https://docs.microsoft.com/en-us/dotnet/api/system.threading.threadpool.setminthreads) with a value larger that the default one.
 
+## Handling events
+`FiddlerApplication` exposes numerous events, described in more details in the [Capture HTTP/S Traffic] article (%slug capture-https-traffic) article.
+
+## Shutdown
+`FidlerCore can be shut down using the following method of `FiddlerApplication`
+- `Shutdown()`: Shuts down FiddlerCore, and reverts the proxy settings to the original ones, in case they were modified on startup.
+>noteIf there is traffic in progress when calling `FiddlerApplication.Shutdown()`, some of the background threads handling the sessions may throw `ObjectDisposedException` or `NullReferenceException`. 
+
 ## Next Steps
 
 - [Register as System Proxy]({%slug register-as-system-proxy %})

basic-usage/import-export-sessions.md

@@ -8,12 +8,12 @@ position: 4
 
 # Import and Export Sessions with FiddlerCore
 
-This article expains how to import and export sessions with FiddlerCore.
+This article explains how to import and export sessions with FiddlerCore.
 
 ## Import Sessions
 
 You can import sessions with FiddlerCore by using the following code:
-
+```c#
     Session[] loaded = Utilities.ReadSessionArchive(sazFilename, false, "", (file, part) =>
     {
         Console.WriteLine($"Enter the password for { part } (or just hit Enter to cancel):");
@@ -22,15 +22,18 @@ You can import sessions with FiddlerCore by using the following code:
         
         return sResult;
     });
+```
 
 ## Export Sessions
 
 You can export sessions with FiddlerCore by using the following code:
-
+```c#
     bool success = Utilities.WriteSessionArchive(filename, sessions.ToArray(), password, false);
+```
 
 ## Custom SAZ Provider
 
-There are cases that you may want to use custom provider to save FiddlerCore sessions. You do this by setting the following property:
-
+There are cases when you may want to use custom provider to save FiddlerCore sessions. You do this by setting the following property:
+```c#
     FiddlerApplication.oSAZProvider = new CustomSazProvider();
+```

basic-usage/register-as-system-proxy.md

@@ -16,16 +16,46 @@ The simplest way to register FiddlerCore as a system proxy is by passing `Fiddle
 ```c#
 FiddlerCoreStartupSettings startupSettings =
     new FiddlerCoreStartupSettingsBuilder()
-        .ListenOnPort(fiddlerCoreListenPort)
         .RegisterAsSystemProxy()
         .Build();
 
 FiddlerApplication.Startup(startupSettings);
 ``` 
 
+There are more basic methods affecting the system proxy settings in the FiddlerCoreStartupSettings. You can read more in [Configuration/Proxy settings]({%slug configuration %}#system-proxy-settings) article.
+
 ## Advanced approach
+Instead of using the basic configuration methods, you can manually modify the proxy settings. The logic for modifying the system connections' proxy settings is separated in the Telerik.NetworkConnections assembly. 
 
+It contains the following key members:
 
+- `INetworkConnectionsDetector`: Base interface representing network connection detector. It contains a single `Detect()` method, which should return a set of `NetworkConnection` instances of a particular type.
+- `NetworkConnection`: Base abstract class which allows manipulation and monitoring of proxy settings for a specific network connection. The most important members are:
+    - `GetCurrentProxySettings()`: Returns the current `ProxySettings` for the connection.
+    - `SetProxySettings(ProxySettings)`: Sets specified proxy settings for the connection.
+    - `ProxySettingsChanged`: Event raised when proxy settings for the connection are changed.
+
+To manually manipulate network connections' proxy settings, you can use any of the built-in detectors, obtain an instance of a NetworkConnection class, and invoke it's `SetProxySettings` method, for example:
+```c#
+// Detect the network connections:
+var networkConnections = new WinINetNetworkConnectionsDetector().Detect();
+
+// Create appropriate proxy settings (in this case bypassing particular hosts):
+var proxySettings = new ProxySettings(true, "https://www.telerik.com");
+
+// Modify some of the network connections:
+networkConnections.First().SetProxySettings(proxySettings);
+
+// Start:
+FiddlerApplication.Startup(new FiddlerCoreStartupSettingsBuilder().Build());
+```
+
+The following default implementations for `INetworkConnectionsDetector` are provided:
+- `WinINetNetworkConnectionsDetector`: detector for Windows-specific Windows Internet (WinINET) networking component network connection.
+- `RasNetworkConnectionsDetector`: detector for Windows-specific RAS network connections.
+- `MacNetworkConnectionsDetector`: Detector for Mac-specific network connections.
+- `LinuxNetworkConnectionsDetector`: Detector for Linux-specific network connections.
+>noteThe built-in connection detectors are OS-specific and will throw exception if invoked on a not-supported platforms.
 
 ## Next Steps
 

basic-usage/use-custom-root-certificate.md

@@ -16,14 +16,15 @@ FiddlerCore will create new certificate every time the application runs. This ex
 ## Set the Default Certificate Provider
 
 The following code explains how to set the default certificate provider for FiddlerCore:
-
+```c#
     BCCertMaker.BCCertMaker certProvider = new BCCertMaker.BCCertMaker();
     CertMaker.oCertProvider = certProvider;
+```
 
 ## Create Root Certificate
 
 The following code explains how to create your own root certificate.
-
+```c#
     string rootCertificatePath = @"Path\To\Your\Root\Certificate\RootCertificate.p12";
     string rootCertificatePassword = "S0m3T0pS3cr3tP4ssw0rd";
     if (!File.Exists(rootCertificatePath))
@@ -31,26 +32,29 @@ The following code explains how to create your own root certificate.
         certProvider.CreateRootCertificate();
         certProvider.WriteRootCertificateAndPrivateKeyToPkcs12File(rootCertificatePath, rootCertificatePassword);
     }
+```
 
 ## Read Root Certificate from File
 
 The following code explains how to create your own root certificate.
-
+```c#
     string rootCertificatePath = @"Path\To\Your\Root\Certificate\RootCertificate.p12";
     string rootCertificatePassword = "S0m3T0pS3cr3tP4ssw0rd";
     if (File.Exists(rootCertificatePath))
     {
         certProvider.ReadRootCertificateAndPrivateKeyFromPkcs12File(rootCertificatePath, rootCertificatePassword);
     }
+```
 
 ## Trust Root Certificate
 
 The following code explains how to trust your root certificate.
-
+```c#
     if (!CertMaker.rootCertIsTrusted())
     {
         CertMaker.trustRootCert();
     }
+```
 
 ## Next Steps
 

getting-started/download-product-files.md

@@ -21,7 +21,7 @@ In order to download these you need to take the following steps:
 
 ![](images/download_product_files_1.png)
 
-**3. Select __Telerik UI for Xamarin__ product title:**
+**3. Select __FiddlerCore__ product title:**
 
 ![](images/download_product_files_2.png)