Add pointers to upgrade doc (#1133)

* Add pointers to upgrade doc

* Update dotnet-desktop-guide/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md

dotnet-desktop-guide/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md

@@ -17,6 +17,9 @@ ms.custom: "mvc,vs-dotnet"
 
 This article shows you how to develop a Windows Presentation Foundation (WPF) desktop application that includes the elements that are common to most WPF applications: Extensible Application Markup Language (XAML) markup, code-behind, application definitions, controls, layout, data binding, and styles. To develop the application, you'll use Visual Studio.
 
+> [!IMPORTANT]
+> This article was written for .NET Framework. To get started with .NET 5 or .NET 6, see [Tutorial: Create a new WPF app (WPF .NET)](/dotnet/desktop/wpf/get-started/create-app-visual-studio?view=netdesktop-5.0&preserve-view=true).
+
 In this tutorial, you learn how to:
 > [!div class="checklist"]
 >

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

@@ -9,13 +9,16 @@ ms.topic: how-to
 
 This article describes how to migrate a Windows Forms desktop app from .NET Framework to .NET 5 or later. The .NET SDK includes support for Windows Forms applications. Windows Forms is still a Windows-only framework and only runs on Windows.
 
-> [!TIP]
-> Try the [.NET Upgrade Assistant](/dotnet/core/porting/upgrade-assistant-winforms-framework) to help migrate your project.
-
 Migrating your app from .NET Framework to .NET 5 generally requires a new project file. .NET 5 uses SDK-style project files while .NET Framework typically uses the older Visual Studio project file. If you've ever opened a Visual Studio project file in a text editor, you know how verbose it is. SDK-style projects are smaller and don't require as many entries as the older project file format does.
 
 To learn more about .NET 5, see [Introduction to .NET](/dotnet/core/introduction).
 
+## Try the upgrade assistant
+
+The .NET Upgrade Assistant is a command-line tool that can be run on different kinds of .NET Framework apps. It's designed to assist with upgrading .NET Framework apps to .NET 5. After running the tool, in most cases the app will require additional effort to complete the migration. The tool includes the installation of analyzers that can assist with completing the migration.
+
+For more information, see [Upgrade a WPF App to .NET 5 with the .NET Upgrade Assistant](/dotnet/core/porting/upgrade-assistant-wpf-framework).
+
 ## Prerequisites
 
 - [Visual Studio 2019 version 16.8 Preview](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2019+desktopguide+winforms)

dotnet-desktop-guide/net/wpf/migration/convert-project-from-net-framework.md

@@ -11,11 +11,16 @@ ms.topic: how-to
 
 This article covers the steps necessary to migrate a Windows Presentation Foundation (WPF) app from .NET Framework to .NET Core 3.0. If you don't have a WPF app on hand to port, but would like to try out the process, you can use the **Bean Trader** sample app available on [GitHub](https://github.com/dotnet/windows-desktop/tree/main/Samples/BeanTrader). The original app (targeting .NET Framework 4.7.2) is available in the NetFx\BeanTraderClient folder. First we'll explain the steps necessary to port apps in general, and then we'll walk through the specific changes that apply to the **Bean Trader** sample.
 
-> [!TIP]
-> Try the [.NET Upgrade Assistant](/dotnet/core/porting/upgrade-assistant-wpf-framework) to help migrate your own project.
-
 [!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)]
 
+## Try the upgrade assistant
+
+The .NET Upgrade Assistant is a command-line tool that can be run on different kinds of .NET Framework apps. It's designed to assist with upgrading .NET Framework apps to .NET 5. After running the tool, in most cases the app will require additional effort to complete the migration. The tool includes the installation of analyzers that can assist with completing the migration.
+
+For more information, see [Upgrade a Windows Forms App to .NET 5 with the .NET Upgrade Assistant](/dotnet/core/porting/upgrade-assistant-winforms-framework).
+
+## Prerequisites
+
 To migrate to .NET Core, you must first:
 
 01. Understand and update NuGet dependencies: