updated readme.md for 6.5.0

README.md

@@ -4,11 +4,36 @@ Windows Azure Active Directory IdentityModel Extensions for .Net
 IdentityModel Extensions for .Net provide assemblies that are interesting for web developers that wish to use federated identity providers for establishing the callers identity. 
 
 ## Versions
-Current version - 5.5.0
-Minimum recommended version - 5.2.2
+Current version - 6.5.0 \
+Minimum recommended version - 5.5.0
 
 You can find the release notes for each version [here](https://github.com/AzureAD/azure-activedirectory-identitymodel-extensions-for-dotnet/releases). Older versions can be found [here](https://github.com/AzureAD/azure-activedirectory-identitymodel-extensions-for-dotnet/wiki/Release-Notes).
 
+## Note about 6.5.0
+If you noticed, we bumped the release from 5.5.0 to 6.5.0.\
+We were maintaining two releases from two different branches.\
+dev - 6.x\
+dev5x - 5.x
+
+Internally at Microsoft we were quickly required to remove all 3rd party libraries as IdentityModel is all about securing resources.\
+Since there were some breaking changes, given the time-line we had to maintain two releases.
+
+Both of these branches were public and moved forward mostly in lock-step.\
+Once we finished our SignedHttpRequest functionality in the 6.x branch, we realized the delta between 5.x aqnd 6.x was too large to maintain in both branches.\
+We decided now was the time to switch to a single release branch.\
+Since internally the versioning was at 6.4.2, we needed to release at 6.5.0.
+
+## There are some small breaking changes, we hope they are small and do not cause any issues.
+We built and tested asp.net core with 6.5.0 without issues.\
+We also upgraded in place existing applications to 6.5.0 without issues.\
+This of course does not mean you will not hit issues, but we took it seriously.
+
+Any questions or compatibility problems please open issues [here] (https://github.com/AzureAD/azure-activedirectory-identitymodel-extensions-for-dotnet/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)
+
+## Thank you for using our product
+The IdentityModel Team.
+
+
 ## Security Vulnerability in Microsoft.IdentityModel.Tokens 5.1.0
 IdentityModel Extensions library Microsoft.IdentityModel.Tokens has a known security vulnerability affecting version 5.1.0. Please update to >= 5.1.1 immediately. An updated package is available on NuGet. For more details, see the [security notice](https://github.com/AzureAD/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/master/SECURITY_NOTICE.md).
 

buildConfiguration.xml

@@ -2,7 +2,7 @@
   <dotnetArchitecture>x64</dotnetArchitecture>
   <nugetVersion>3.5.0-rc-1285</nugetVersion>
   <runtimes>net45,net461,netstandard2.0</runtimes>
-  <assemblyVersion>6.4.2</assemblyVersion>
+  <assemblyVersion>6.5.1</assemblyVersion>
   <nugetSuffix>preview</nugetSuffix>
   <projects>
     <src>