getstart above sample

Author: mikehoffms

microsoft-edge/toc.yml

@@ -1286,6 +1286,10 @@
                 - name: WebView2 in Win32 apps
                   href: ./webview2/platforms/win32.md
 
+                - name: Get started with WebView2 in Win32 apps
+                  href: ./webview2/get-started/win32.md
+                  displayName: Win32_GettingStarted  # repo dir name
+
                 - name: Win32 sample app
                   href: ./webview2/samples/webview2apissample.md
                   displayName: WebView2APISample, SampleApps # repo dir names
@@ -1298,41 +1302,41 @@
                   href: ./webview2/samples/webview2browser.md
                   displayName: WebView2Browser  # repo dir name
 
-                - name: Get started with WebView2 in Win32 apps
-                  href: ./webview2/get-started/win32.md
-                  displayName: Win32_GettingStarted  # repo dir name
-
             - name: WinUI 2 (UWP)
               items:
                 - name: WebView2 in WinUI 2 (UWP) apps
                   href: ./webview2/platforms/winui2-uwp.md
 
-                - name: WinUI 2 (UWP) sample app
-                  href: ./webview2/samples/webview2_sample_uwp.md
-                  displayName: webview2_sample_uwp  # repo dir name
-
                 - name: Get started with WebView2 in WinUI 2 (UWP) apps
                   href: ./webview2/get-started/winui2.md
                   displayName: WinUI2_GettingStarted  # repo dir name
 
+                - name: WinUI 2 (UWP) sample app
+                  href: ./webview2/samples/webview2_sample_uwp.md
+                  displayName: webview2_sample_uwp  # repo dir name
+
             - name: WinUI 3 (Windows App SDK)
               items:
                 - name: WebView2 in WinUI 3 (Windows App SDK) apps
                   href: ./webview2/platforms/winui3-windows-app-sdk.md
 
-                - name: WinUI 3 (Windows App SDK) sample app
-                  href: ./webview2/samples/webview2-winui3-sample.md
-                  displayName: WebView2_WinUI3_Sample  # repo dir name
-
                 - name: Get started with WebView2 in WinUI 3 (Windows App SDK) apps
                   href: ./webview2/get-started/winui.md
                   displayName: WinUI3_GettingStarted  # repo dir name
 
+                - name: WinUI 3 (Windows App SDK) sample app
+                  href: ./webview2/samples/webview2-winui3-sample.md
+                  displayName: WebView2_WinUI3_Sample  # repo dir name
+
             - name: WPF
               items:
                 - name: WebView2 in WPF apps
                   href: ./webview2/platforms/wpf.md
 
+                - name: Get started with WebView2 in WPF apps
+                  href: ./webview2/get-started/wpf.md
+                  displayName: WPF_GettingStarted  # repo dir name
+
                 - name: WPF sample app
                   href: ./webview2/samples/webview2wpfbrowser.md
                   displayName: WebView2WpfBrowser  # repo dir name
@@ -1341,23 +1345,19 @@
                   href: ./webview2/samples/wv2cdpextensionwpfsample.md
                   displayName: WV2CDPExtensionWPFSample  # repo dir name
 
-                - name: Get started with WebView2 in WPF apps
-                  href: ./webview2/get-started/wpf.md
-                  displayName: WPF_GettingStarted  # repo dir name
-
             - name: WinForms
               items:
                 - name: WebView2 in WinForms apps
                   href: ./webview2/platforms/winforms.md
 
-                - name: WinForms sample app
-                  href: ./webview2/samples/webview2windowsformsbrowser.md
-                  displayName: WebView2WindowsFormsBrowser  # repo dir name
-
                 - name: Get started with WebView2 in WinForms apps
                   href: ./webview2/get-started/winforms.md
                   displayName: WinForms_GettingStarted  # repo dir name
 
+                - name: WinForms sample app
+                  href: ./webview2/samples/webview2windowsformsbrowser.md
+                  displayName: WebView2WindowsFormsBrowser  # repo dir name
+
             - name: HoloLens 2 Unity
               items:
                 - name: WebView2 in HoloLens 2 Unity apps
@@ -1367,13 +1367,13 @@
                   href: ./webview2/get-started/hololens2.md
                   displayName: HoloLens2_GettingStarted  # repo dir name
 
-            - name: WebView2 sample apps
-              href: ./webview2/code-samples-links.md  # delete & redir?
-
             - name: Getting Started tutorials
               href: ./webview2/get-started/get-started.md  # delete & redir?
               displayName: GettingStartedGuides  # repo dir name
 
+            - name: WebView2 sample apps
+              href: ./webview2/code-samples-links.md  # delete & redir?
+
 # -----------------------------------------------------------------------------
         - name: Navigation, events, and authentication
           items:

microsoft-edge/webview2/get-started/get-started.md

@@ -10,7 +10,8 @@ ms.date: 02/22/2023
 ---
 # Getting Started tutorials
 
-These articles cover how to set up your development tools and create an initial WebView2 app, like a Hello World app with basic functionality.  Learn about WebView2 concepts along the way.
+These articles cover how to set up your development tools and create an initial WebView2 app, like a Hello World app with basic functionality.  You learn WebView2 concepts along the way.  If you want to first install and run a sample, see [Win32 sample app](../samples/webview2apissample.md) or another sample app article.
+
 
 | Article | Completed project | Description |
 |---|---|---|

microsoft-edge/webview2/get-started/hololens2.md

@@ -12,6 +12,8 @@ ms.date: 11/25/2024
 
 This tutorial is for developers using WebView2 in immersive HoloLens 2 Unity applications.
 
+This article is to learn to write your own WebView2 code.  If you want to first install and run a sample, see [Win32 sample app](../samples/webview2apissample.md) or another sample app article.
+
 > [!IMPORTANT]
 > WebView2 on Hololens 2 continues to be available.  However, support for WebView2 on Hololens 2 is discontinued; there are no planned bug fixes or content updates, and technical support has ended.  Applications that use WebView2 on Hololens 2 are not guaranteed to continue to work.
 

microsoft-edge/webview2/get-started/win32.md

@@ -12,6 +12,8 @@ ms.date: 07/29/2022
 
 <!-- TODO: Rewrite to start from a project template? -->
 
+This article is to learn to write your own WebView2 code.  If you want to first install and run a sample, see [Win32 sample app](../samples/webview2apissample.md) or another sample app article.
+
 In this article, you set up your development tools (if not done already), learn how to add WebView2 code to a Win32 app project, and learn about WebView2 concepts along the way.
 
 This tutorial starts by opening an existing Win32 app project that has WebView2 code added.  The project uses the [Win32_GettingStarted (WebView2GettingStarted.sln)](https://github.com/MicrosoftEdge/WebView2Samples/tree/main/GettingStartedGuides/Win32_GettingStarted) directory that's part of the `WebView2Samples` repo.  To use this article, you do the following:

microsoft-edge/webview2/get-started/winforms.md

@@ -10,6 +10,8 @@ ms.date: 10/26/2022
 ---
 # Get started with WebView2 in WinForms apps
 
+This article is to learn to write your own WebView2 code.  If you want to first install and run a sample, see [Win32 sample app](../samples/webview2apissample.md) or another sample app article, such as [WinForms sample app](../samples/webview2windowsformsbrowser.md).
+
 <!--
 todo: errors experienced with vs2022 by following these instructions:
 *  The addressbar text box & Go button shift to the right when alt+tab to the Form1 window. 

microsoft-edge/webview2/get-started/winui.md

@@ -10,6 +10,8 @@ ms.date: 11/01/2024
 ---
 # Get started with WebView2 in WinUI 3 (Windows App SDK) apps
 
+This article is to learn to write your own WebView2 code.  If you want to first install and run a sample, see [Win32 sample app](../samples/webview2apissample.md) or another sample app article, such as [WinUI 3 (Windows App SDK) sample app](../samples/webview2-winui3-sample.md).
+
 This article covers how to set up your development tools and create an initial WebView2 app for WinUI 3 (Windows App SDK), and learn about WebView2 concepts along the way.  You first use the **Blank App, Packaged (WinUI 3 in Desktop)** Visual Studio project template, which uses the WindowsAppSDK, which includes the WebView2 SDK.  You then add a WebView2 control, an Address bar and **Go** button, and URL logic to only allow navigating to HTTPS URLs.
 
 

microsoft-edge/webview2/get-started/winui2.md

@@ -10,6 +10,8 @@ ms.date: 10/31/2023
 ---
 # Get started with WebView2 in WinUI 2 (UWP) apps
 
+This article is to learn to write your own WebView2 code.  If you want to first install and run a sample, see [Win32 sample app](../samples/webview2apissample.md) or another sample app article, such as [WinUI 2 (UWP) sample app](../samples/webview2_sample_uwp.md).
+
 In this tutorial, you:
 *  Set up your development tools for creating UWP apps that use WebView2 to display web content.
 *  Create an initial WinUI 2 (UWP) app.

microsoft-edge/webview2/get-started/wpf.md

@@ -10,6 +10,8 @@ ms.date: 09/19/2022
 ---
 # Get started with WebView2 in WPF apps
 
+This article is to learn to write your own WebView2 code.  If you want to first install and run a sample, see [Win32 sample app](../samples/webview2apissample.md) or another sample app article, such as [WPF sample app](../samples/webview2wpfbrowser.md).
+
 This article covers how to set up your development tools and create an initial WebView2 app for Windows Presentation Foundation (WPF), and learn about WebView2 concepts along the way.
 
 In this tutorial, you use the **WPF Application** or **WPF App (.NET Framework)** project template to create a WPF app, and then install the WebView2 SDK for the project to add WebView2.

microsoft-edge/webview2/index.md

@@ -132,7 +132,7 @@ developer.microsoft.com:
 * [Microsoft Edge WebView2](https://developer.microsoft.com/microsoft-edge/webview2) - initial introduction to WebView2 features at developer.microsoft.com.
 
 Microsoft.com:
-* [Become a Microsoft Edge Insider](https://www.microsoft.com/en-us/edge/download/insider) - download the preview channels of Microsoft Edge (Canary, Dev, and Beta).
+* [Become a Microsoft Edge Insider](https://www.microsoft.com/edge/download/insider) - download the preview channels of Microsoft Edge (Canary, Dev, and Beta).
 
 YouTube:
 * [Building, Deploying, and Managing WebView2 Applications](https://www.youtube.com/watch?v=LX-eXvcSx6c) - March 2, 2021.

microsoft-edge/webview2/platforms/wpf.md

@@ -49,6 +49,6 @@ n/a
 
 * [WebView2CompositionControl Class](/dotnet/api/microsoft.web.webview2.wpf.webview2compositioncontrol)
 
-* [WPF Airspace - WebView2CompositionControl](https://github.com/MicrosoftEdge/WebView2Feedback/blob/main/specs/WPF_WebView2CompositionControl.md) - Spec.
-
+Airspace:
 * [Mitigating Airspace Issues In WPF Applications](https://dwayneneed.github.io/wpf/2013/02/26/mitigating-airspace-issues-in-wpf-applications.html)
+* [WPF Airspace - WebView2CompositionControl](https://github.com/MicrosoftEdge/WebView2Feedback/blob/main/specs/WPF_WebView2CompositionControl.md) - Spec.