Update release and breaking change READMEs

Documentation/README.md

@@ -0,0 +1,11 @@
+# Documentation
+
+The following documents are available in this repo:
+
+- [.NET Framework Breaking Changes](breaking-changes/README.md)
+- [.NET Framework Release Notes](../releases/README.md)
+
+The following .NET Framework documentation is available from Microsoft:
+
+- [.NET Framework Documentation](https://docs.microsoft.com/dotnet/articles/framework/)
+- [.NET Core Documentation](https://docs.microsoft.com/dotnet/articles/core/)

Documentation/breaking-changes/unicode-data-now-support-standard-v8_0-categories.md

@@ -1,4 +1,4 @@
-## .Net Framework now supports Unicode standard version 8.0 categories
+## Unicode standard version 8.0 categories now supported
 
 ### Scope
 Minor

README.md

@@ -7,7 +7,7 @@ This repo is not an official .NET Framework support location, however, we will r
 ## In this repository
 
 - [.NET Framework Release Notes](releases/README.md)
-- [.NET Framework Breaking Changes](Documentation/breaking-changes/README.md)
+- [.NET Framework Documentation](Documentation/README.md)
 - [.NET Open Source Developer Projects](dotnet-developer-projects.md)
 - [.NET Open Source Consumer Projects](dotnet-consumer-projects.md)
 - [Free Services & Tools for Open Source .NET Projects](dotnet-free-oss-services.md)

releases/README.md

@@ -4,35 +4,19 @@ You can learn about .NET Framework [releases](#releases), below. See [resources]
 
 To get up-to-date with the latest versions of .NET Framework and Visual Studio, see [Install the .NET Framework](https://www.microsoft.com/net/framework/versions) and  [Install Visual Studio](https://www.visualstudio.com/vs/). See [Targeting .NET Platforms](https://www.microsoft.com/net/targeting) to find additional tools.
 
-## Releases
+## Release Notes
 
 You can see what was included in each .NET Framework release. Some releases are now unsupported, as called out.
-- .NET Framework 4.7 
-   - [Announcement blog post](https://go.microsoft.com/fwlink/?linkid=845636)
-   - [Release notes](net47/README.md)
-- .NET Framework 4.6.2 
-   - [Announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2016/08/02/announcing-net-framework-4-6-2/)
-   - [Release notes](net462/README.md)
-- .NET Framework 4.6.1 
-   - [Announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2015/11/30/net-framework-4-6-1-is-now-available/)
-   - [Release notes](net461)
-   - [Known issues](https://support.microsoft.com/en-us/help/3102432/known-issues-for-the-.net-framework-4.6.1) 
-- .NET Framework 4.6 
-   - [Announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2015/07/20/announcing-net-framework-4-6/)
-   - [Release notes](net46) 
-   - [Known issues](https://support.microsoft.com/en-us/help/3047761/known-issues-for-the-.net-framework-4.6)
-- .NET Framework 4.5.2 
-   - [Announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2014/05/05/announcing-the-net-framework-4-5-2/)
-   - [Known issues](https://support.microsoft.com/en-us/help/2962547/known-issues-for-the-.net-framework-4.5.2)
-- .NET Framework 4.5.1 (unsupported)
-   - [Announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2013/10/17/net-framework-4-5-1-rtm-start-coding/)
-   - [Known issues](https://support.microsoft.com/en-us/help/2890857/known-issues-for-the-.net-framework-4.5.1)
-- .NET Framework 4.5 (unsupported)
-   - [Announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2012/08/15/announcing-the-release-of-net-framework-4-5-rtm-product-and-source-code/)
-- .NET Framework 4.0.3 (unsupported)
-   - [Announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2012/03/05/update-4-0-3-for-the-microsoft-net-framework-4/)
-- .NET Framework 4.0.2 (unsupported)
-   - [Announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2011/10/27/update-4-0-2-for-the-microsoft-net-framework-4/)
+
+- [.NET Framework 4.7](net47/README.md)
+- [.NET Framework 4.6.2](net462/README.md)
+- [.NET Framework 4.6.1](net461/README.md)
+- [.NET Framework 4.6](net46/README.md)
+- [.NET Framework 4.5.2](net452/README.md)
+- [.NET Framework 4.5.1](net451/README.md) (unsupported)
+- [.NET Framework 4.5](https://blogs.msdn.microsoft.com/dotnet/2012/08/15/announcing-the-release-of-net-framework-4-5-rtm-product-and-source-code/) (unsupported)
+- [.NET Framework 4.0.3](https://blogs.msdn.microsoft.com/dotnet/2012/03/05/update-4-0-3-for-the-microsoft-net-framework-4/) (unsupported)
+- [.NET Framework 4.0.2](https://blogs.msdn.microsoft.com/dotnet/2011/10/27/update-4-0-2-for-the-microsoft-net-framework-4/) (unsupported)
 
 ## Resources
 
@@ -42,4 +26,4 @@ You can see what was included in each .NET Framework release. Some releases are
 - [.NET Framework Reference Source](https://referencesource.microsoft.com/)
 - [.NET Framework reference source on GitHub (microsoft/referencesource)](https://github.com/microsoft/referencesource)
 - [.NET Core Releases (dotnet/core)](https://github.com/dotnet/core/blob/master/release-notes/README.md)
-- [ASP.NET Core Releases (aspnet/home)](https://github.com/aspnet/Home/releases)
+- [ASP.NET Core Releases (aspnet/home)](https://github.com/aspnet/Home/releases)

releases/net45/README.md

@@ -0,0 +1,9 @@
+# .NET Framework 4.5 Release Notes
+
+You can learn about the changes made in the .NET Framework 4.5.
+
+The .NET Framework 4.5 is no longer supported by Microsoft.
+
+- [.NET Framework 4.5 announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2013/10/17/net-framework-4-5-1-rtm-start-coding/)
+- [What's new in the .NET Framework 4.5](https://docs.microsoft.com/dotnet/articles/framework/whats-new/index#v45)
+- [Known issues](https://support.microsoft.com/en-us/help/2890857/known-issues-for-the-.net-framework-4.5)

releases/net451/README.md

@@ -0,0 +1,9 @@
+# .NET Framework 4.5.1 Release Notes
+
+You can learn about the changes made in the .NET Framework 4.5.1.
+
+The .NET Framework 4.5.1 is no longer supported by Microsoft.
+
+- [.NET Framework 4.5.1 announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2013/10/17/net-framework-4-5-1-rtm-start-coding/)
+- [What's new in the .NET Framework 4.5.1](https://docs.microsoft.com/dotnet/articles/framework/whats-new/index#v451)
+- [Known issues](https://support.microsoft.com/en-us/help/2890857/known-issues-for-the-.net-framework-4.5.1)

releases/net452/README.md

@@ -0,0 +1,7 @@
+# .NET Framework 4.5.2 Release Notes
+
+You can learn about the changes made in the .NET Framework 4.5.2.
+
+- [.NET Framework 4.5.2 announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2014/05/05/announcing-the-net-framework-4-5-2/)
+- [What's new in the .NET Framework 4.5.2](https://docs.microsoft.com/dotnet/articles/framework/whats-new/index#v452)
+- [Known issues](https://support.microsoft.com/en-us/help/2962547/known-issues-for-the-.net-framework-4.5.2)

releases/net46/README.md

@@ -0,0 +1,21 @@
+# .NET Framework 4.6 Release Notes
+
+You can learn about the changes made in the .NET Framework 4.6.
+
+- [.NET Framework 4.6 announcement blog post](https://blogs.msdn.microsoft.com/dotnet/2015/07/20/announcing-net-framework-4-6/)
+- [What's new in the .NET Framework 4.6](https://docs.microsoft.com/dotnet/articles/framework/whats-new/index#v46)
+- [Release notes](dotnet46-changes.md)
+- [API changes](dotnet46-api-changes.md)
+- [Reference Source](https://github.com/Microsoft/referencesource/commit/ec178a5e7deb87a9cc7e0982ee32b7d965735b16)
+- [Known issues](https://support.microsoft.com/en-us/help/3047761/known-issues-for-the-.net-framework-4.6)
+
+# Release Notes by Product Area
+
+- [ASP.NET](dotnet46-changes.md#aspnet)
+- [BCL](dotnet46-changes.md#bcl)
+- [CLR](dotnet46-changes.md#clr)
+- [Entity Framework](dotnet46-changes.md#entity-framework)
+- [WCF](dotnet46-changes.md#wcf)
+- [Windows Forms](dotnet46-changes.md#windows-forms)
+- [Workflow](dotnet46-changes.md#workflow)
+- [WPF](dotnet46-changes.md#wpf)