Move to .net 6

Author: Jan Jahoda

docs/core/compatibility/6.0.md

@@ -21,6 +21,10 @@ If you're migrating an app to .NET 6.0, the breaking changes listed here might a
 
 - [Changes to nullable reference type annotations](core-libraries/6.0/nullable-ref-type-annotation-changes.md)
 
+## Networking
+
+- [WebRequest, WebClient, and ServicePoint are deprecated](networking/6.0/webrequest-deprecate.md)
+
 ## Windows Forms
 
 - [Selected TableLayoutSettings properties throw InvalidEnumArgumentException](windows-forms/6.0/tablelayoutsettings-apis-throw-invalidenumargumentexception.md)

docs/core/compatibility/networking/6.0/webrequest-deprecate.md

@@ -0,0 +1,47 @@
+---
+title: "Breaking change: WebRequest, WebClient, and ServicePoint are deprecated"
+description: Learn about the breaking change in .NET 6.0 where WebRequest, WebClient, and ServicePoint are deprecated.
+ms.date: ??/??/??
+---
+
+### WebRequest, WebClient, and ServicePoint are deprecated
+
+<xref:System.Net.WebRequest>, <xref:System.Net.WebClient>, and <xref:System.Net.ServicePoint> classes are deprecated.
+
+#### Version introduced
+
+6.0
+
+#### Change description
+
+<xref:System.Net.WebRequest>, <xref:System.Net.WebClient>, and <xref:System.Net.ServicePoint> classes were added to .NET Core in version 2.0 for backward compatibility. However, they introduced several runtime breaking changes, for example, `WebRequest.GetRequestStream` allocates memory for the whole response, and `WebClient.CancelAsync` doesn't always cancel immediately.
+
+Starting in .NET 5.0, the <xref:System.Net.WebRequest>, <xref:System.Net.WebClient>, and <xref:System.Net.ServicePoint> classes are deprecated. The classes are still available, but they are not recommended for new development. To reduce the number of analyzer warnings, only construction methods are decorated with the <xref:System.ObsoleteAttribute> attribute.
+
+#### Recommended action
+
+Use the <xref:System.Net.Http.HttpClient?displayProperty=fullName> class instead.
+
+#### Affected APIs
+
+- <xref:System.Net.WebRequest>
+- <xref:System.Net.HttpWebRequest>
+- <xref:System.Net.FtpWebRequest>
+- <xref:System.Net.WebClient>
+- <xref:System.Net.ServicePoint>
+
+<!--
+
+#### Affected APIs
+
+- `T:System.Net.WebRequest`
+- `T:System.Net.HttpWebRequest`
+- `T:System.Net.FtpWebRequest`
+- `T:System.Net.WebClient`
+- `T:System.Net.ServicePoint`
+
+### Category
+
+Networking
+
+-->