Document connecting to a reverse proxy

src/NATS.sln

@@ -117,8 +117,6 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "JetStreamPushSubscribeAsync
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SimplificationQueue", "Samples\SimplificationQueue\SimplificationQueue.csproj", "{F8609197-D5B0-42CC-890E-921CAAA1589E}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TLSReverseProxyExample", "Samples\TLSReverseProxyExample\TLSReverseProxyExample.csproj", "{98C52074-7693-48D4-B0A9-48920EEEDA24}"
-EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ChaosTestApp", "Samples\ChaosTestApp\ChaosTestApp.csproj", "{649DEBB2-E0AC-47ED-AA39-B119F512C204}"
 EndProject
 Global
@@ -385,7 +383,6 @@ Global
 		{C7FB00D4-23F1-4F6A-A8C0-E58346F272DE} = {776C2E80-958B-4C0D-BCC4-67D39DB4570B}
 		{5DCD0666-5AC9-462F-99BD-5E8E95E4B749} = {776C2E80-958B-4C0D-BCC4-67D39DB4570B}
 		{F8609197-D5B0-42CC-890E-921CAAA1589E} = {776C2E80-958B-4C0D-BCC4-67D39DB4570B}
-		{98C52074-7693-48D4-B0A9-48920EEEDA24} = {776C2E80-958B-4C0D-BCC4-67D39DB4570B}
 		{649DEBB2-E0AC-47ED-AA39-B119F512C204} = {776C2E80-958B-4C0D-BCC4-67D39DB4570B}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution

src/Samples/README.md

@@ -12,8 +12,8 @@ This folder contains a number of samples:
 1. `Replier` - A sample replier for the Requestor application.
 1. `RxSample` - Rx integration / functionality
 1. `Subscribe` - A sample subscriber.
-1. `WinFormsSample`
-1. `TlsVariationsExample`
+1. `WinFormsSample` - Use the client within a Windows application.
+1. `TlsVariationsExample` - Some examples setting up the client for TLS
 1. `JetStreamStarter` - A starter app for JetStream projects. 
 
 ### Simplification

src/Samples/TlsVariationsExample/README.md

@@ -0,0 +1,36 @@
+![NATS](https://raw.githubusercontent.com/nats-io/nats.net/main/documentation/large-logo.png)
+
+# TLS Variations
+
+This project is simply some example code to jump start setting up TLS in the client.
+There are also unit tests and corresponding configuration files which may be of use.
+
+## Using a Reverse Proxy
+
+In a reverse proxy configuration, the client connects securely to the reverse proxy
+and the proxy may connect securely or insecurely to the server.
+
+If the proxy connects securely to the server, 
+then there is nothing special required to do at all.
+
+But most commonly, the proxy connects insecurely to the server. 
+This is where server configuration comes into play. 
+You will need to configure the server like so:
+
+```
+tls {}
+allow_non_tls: true
+```
+
+Before this, the client would not connect 
+because the server was not requiring tls for the proxy, 
+but the client was configured as secure because it was connecting securely to the proxy. 
+The client thought that this was a mismatch and would not connect, 
+essentially failing fast instead of waiting for the server to reject the connection attempt.
+
+The latest version of the client is able to recognize this server configuration 
+and understands that it's okay to connect securely to the proxy regardless of the 
+server configuration.
+
+You just have to make sure you can properly connect securely to the proxy 
+and that's where the code in this sample comes in.