Merge pull request #117 from dotnet/publish-28416

Merge master into live

dotnet-desktop-guide/net/winforms/index.yml

@@ -16,10 +16,10 @@ landingContent:
   # Card
   - title: Learn about Windows Forms
     linkLists:
-      - linkListType: download
+      - linkListType: whats-new
         links:
-          - text: Visual Studio 2019 version 16.8 Preview
-            url: https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2019+desktopguide+winforms
+          - text: What's new
+            url: whats-new/index.md
       - linkListType: overview
         links:
           - text: Windows Forms overview
@@ -28,6 +28,12 @@ landingContent:
         links:
           - text: Create a new app
             url: get-started/create-app-visual-studio.md
+          - text: Migrate from .NET Framework
+            url: migration/index.md
+      - linkListType: download
+        links:
+          - text: Visual Studio 2019 version 16.8
+            url: https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2019+desktopguide+winforms
 
   - title: Controls
     linkLists:

dotnet-desktop-guide/net/winforms/migration/index.md

@@ -221,7 +221,7 @@ After you've finished migrating your app, test it!
 
 ## Next steps
 
-- Learn about [breaking changes from .NET Framework to .NET Core](/dotnet/core/compatibility/fx-core#windows-forms).
+- Learn about [breaking changes in Windows Forms](/dotnet/core/compatibility/winforms).
 - Read more about the [Windows Compatibility Pack][compat-pack].
 
 [compat-pack]: /dotnet/core/porting/windows-compat-pack

dotnet-desktop-guide/net/winforms/overview/index.md

@@ -32,6 +32,10 @@ With Windows Forms, you develop graphically rich apps that are easy to deploy, u
 
 To learn how to create a Windows Forms app, see [Tutorial: Create a new WinForms app (Windows Forms .NET)](../get-started/create-app-visual-studio.md).
 
+## Why migrate from .NET Framework
+
+Windows Forms for .NET 5.0 provides new features and enhancements over .NET Framework. For more information, see [What's new (Windows Forms.NET)](../whats-new/index.md). To learn how to migrate an app, see [How to migrate a Windows Forms desktop app to .NET 5](../migration/index.md).
+
 ## Build rich, interactive user interfaces
 
 Windows Forms is a UI technology for .NET, a set of managed libraries that simplify common app tasks such as reading and writing to the file system. When you use a development environment like Visual Studio, you can create Windows Forms smart-client apps that display information, request input from users, and communicate with remote computers over a network.

dotnet-desktop-guide/net/winforms/toc.yml

@@ -1,6 +1,8 @@
 items:
 - name: Windows Forms for .NET
   href: index.yml
+- name: What's new
+  href: whats-new/index.md
 - name: Get started
   items:
   - name: Overview

dotnet-desktop-guide/net/winforms/whats-new/index.md

@@ -0,0 +1,62 @@
+---
+title: What's new in Windows Forms
+description: Learn about what's new in Windows Forms for .NET. Windows Forms. .NET provides new features and enhancements over .NET Framework.
+ms.date: 11/05/2020
+ms.topic: conceptual
+---
+
+# What's new (Windows Forms.NET)
+
+Windows Forms for .NET 5.0 adds the following features and enhancements over .NET Framework.
+
+There are a few breaking changes you should be aware of when migrating from .NET Framework to .NET 5.0. For more information, see [Breaking changes in Windows Forms](/dotnet/core/compatibility/winforms).
+
+## Enhanced features
+
+- Microsoft UI Automation patterns work better with accessibility tools like Narrator and Jaws.
+- Improved performance and reliability.
+- Better support for high DPI resolutions such as 4k monitors.
+- The default font matches the current Windows design recommendations.
+
+  > [!CAUTION]
+  > This may impact the layout of apps migrated from .NET Framework.
+
+## New controls
+
+The following controls have been added since Windows Forms was ported to .NET Framework:
+
+- <xref:System.Windows.Forms.TaskDialog?displayProperty=fullName>
+  
+  A task dialog is a dialog box that can be used to display information and receive simple input from the user. Like a message box, it's formatted by the operating system according to parameters you set. Task dialog has more features than a message box. For more information, see the [Task dialog sample](https://github.com/dotnet/samples/tree/master/windowsforms/TaskDialogDemo).
+
+- <xref:Microsoft.Web.WebView2.WinForms.WebView2?displayProperty=fullName>
+
+  A new web browser control with modern web support. Based on Edge (Chromium). For more information, see [Getting started with WebView2 in Windows Forms](/microsoft-edge/webview2/gettingstarted/winforms).
+
+## Enhanced controls
+
+- <xref:System.Windows.Forms.ListView?displayProperty=fullName>
+
+  - Supports collapsible groups.
+  - Footers
+  - Group subtitle, task, title images, and collapse/expand functionality.
+
+- <xref:System.Windows.Forms.FolderBrowserDialog?displayProperty=fullName>
+
+  This dialog has been upgraded to use the modern Windows experience instead of the old Windows 7 experience.
+
+- <xref:System.Windows.Forms.FileDialog?displayProperty=fullName>
+
+  - Added support for <xref:System.Windows.Forms.FileDialog.ClientGuid>.
+
+    `ClientGuid` enables a calling application to associate a GUID with a dialog's persisted state. A dialog's state can include factors such as the last visited folder and the position and size of the dialog. Typically, this state is persisted based on the name of the executable file. With `ClientGuid`, an application can persist  different states of the dialog within the same application.
+
+- <xref:System.Windows.Forms.TextRenderer?displayProperty=fullName>
+
+  Support added for <xref:System.ReadOnlySpan%601> to enhance performance of rendering text.
+
+## See also
+
+- [Breaking changes in Windows Forms](/dotnet/core/compatibility/winforms)
+- [Tutorial: Create a new WinForms app (Windows Forms .NET)](../get-started/create-app-visual-studio.md)
+- [How to migrate a Windows Forms desktop app to .NET 5](../migration/index.md)