Merged main into live

Author: QuinnRadich

hub/apps/develop/data-access/mysql-database.md

@@ -1,7 +1,9 @@
 ---
 title: Use a MySQL database in a Windows app
 description: Learn how to connect to a MySQL database from your Windows app, and test your connection using sample code.
-ms.date: 08/01/2024
+ms.date: 01/23/2025
+ms.collection: ce-skilling-ai-copilot
+ms.custom: copilot-scenario-highlight
 ms.topic: how-to
 keywords: windows, windows app sdk, MySQL, database, uwp, wpf, winforms, windows forms, winui
 ms.localizationpriority: medium
@@ -21,6 +23,9 @@ This example can be used with any WPF, Windows Forms, WinUI 3, and UWP project t
 
 This will allow you to programmatically access MySQL databases.
 
+> [!NOTE]
+> [MySQL Connector/NET](https://dev.mysql.com/downloads/connector/net/) version 6.4.4 or later is required to use the `MySql.Data` package with Windows authentication.
+
 ## Test your connection using sample code
 
 The following is an example of connecting to and reading from a remote MySQL database. Note that the server address and database name will need to be customized.
@@ -46,8 +51,19 @@ using (var mySqlCn = new MySqlConnection(M_str_sqlcon))
 > [!IMPORTANT]
 > In production applications, connection information should be stored securely in app configuration (see [**Adding Azure App Configuration by using Visual Studio Connected Services**](/visualstudio/azure/vs-azure-tools-connected-services-app-configuration)). Connection strings and other secrets should not be hard-coded.
 
-> [!NOTE]
-> [MySQL Connector/NET](https://dev.mysql.com/downloads/connector/net/) version 6.4.4 or later is required to use the `MySql.Data` package with Windows authentication.
+## Building a connection string with GitHub Copilot
+
+You can use GitHub Copilot to build the connection string for your MySQL database. You can customize the prompt to create a connection string per your requirements.
+
+The following text shows an example prompt for Copilot Chat that generates a connection string similar to the one shown in the previous code snippet:
+
+```copilot-prompt
+Show me how to create a MySQL connection string to a server named myServerAddress and a database called myDatabase. Use Windows authentication.
+```
+
+GitHub Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://aka.ms/copilot-general-use-faqs).
+
+Learn more about [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states) and [GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/overview).
 
 ## Related content
 

hub/apps/windows-dotnet-maui/index.md

@@ -1,10 +1,11 @@
 ---
 title: Build Windows apps with .NET MAUI
 description: Learn about .NET MAUI, benefits it provides to Windows developers, and how take your Windows apps cross-platform.
-ms.topic: article
-ms.date: 05/09/2024
+ms.topic: concept-article
+ms.date: 01/23/2025
 keywords: windows win32, desktop development, Windows App SDK, .net maui
 ms.localizationpriority: medium
+#Customer intent: As a Windows developer, I want to learn about .NET MAUI, the benefits it provides to Windows developers, and how to take my Windows apps cross-platform.
 ---
 
 # Build Windows apps with .NET MAUI
@@ -28,6 +29,9 @@ If you are planning to build a new app for Windows and want to target additional
 - **Native Controls**: .NET MAUI does not currently support using Windows App SDK controls. If you have existing controls from other Windows App SDK projects you intend to re-use or rely on 3rd Party or open source controls, you will need to find alternatives for .NET MAUI projects.
 - **Closer to Windows**: When writing .NET MAUI apps, it outputs a Windows App SDK app, but there is some translation to get from your code to the native Windows app. With Windows App SDK, you are eliminating that translation step and are less likely to encounter issues with styles, API compatibility, or layout.
 
+> [!TIP]
+> Are you still deciding between .NET MAUI, WinUI, and other UI framework options? Check out the [Windows developer FAQ](../get-started/windows-developer-faq.yml) to learn about the different options for building native Windows apps. Then go watch the **Windows Dev Chat** episode on **Choosing your ideal dev platform**. The segment about [.NET MAUI](https://www.youtube.com/watch?v=4PJBJ8GICjM&list=PLI_J2v67C23bxTffW4XewbUEAOfSVZkrk&index=2&t=2193s) hosted by Beth Massi walks through examples and reasons for choosing .NET MAUI for your next app.
+
 ## .NET MAUI resources for Windows developers
 
 ### .NET MAUI documentation
@@ -45,7 +49,7 @@ This [one-day live stream](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oWeP
 ### .NET MAUI blog posts
 
 - [5 .NET MAUI Features for Building Great Desktop Apps](https://devblogs.microsoft.com/dotnet/5-dotnet-maui-desktop-features/)
-- [Build Your Own Podcast App with .NET 7, Blazor, and .NET MAUI](https://devblogs.microsoft.com/dotnet/build-your-own-podcast-app-with-dotnet-blazor-and-dotnet-maui/)
+- [Build Your Own Podcast App with .NET, Blazor, and .NET MAUI](https://devblogs.microsoft.com/dotnet/build-your-own-podcast-app-with-dotnet-blazor-and-dotnet-maui/)
 
 ### GitHub
 
@@ -82,12 +86,10 @@ If you haven't enabled development mode on your PC, see [Enable your device for
 
 Check out a walk-through of [creating your first .NET MAUI app on Windows](./walkthrough-first-app.md).
 
-## Related topics
+## Related content
 
 [What is .NET MAUI](/dotnet/maui/what-is-maui)
 
-[.NET MAUI supported platforms](/dotnet/maui/supported-platforms)
-
-[WinUI overview](../winui/winui3/index.md)
+[Windows developer FAQ](../get-started/windows-developer-faq.yml)
 
 [.NET MAUI Community Toolkit documentation](/dotnet/communitytoolkit/maui/)

hub/apps/windows-dotnet-maui/walkthrough-first-app.md

@@ -1,10 +1,11 @@
 ---
 title: Build your first .NET MAUI app for Windows
 description: Get hands-on with .NET MAUI by building your first cross-platform app on Windows.
-ms.topic: article
-ms.date: 08/15/2022
+ms.topic: how-to
+ms.date: 01/23/2025
 keywords: windows win32, desktop development, Windows App SDK, .net maui
 ms.localizationpriority: medium
+#Customer intent: As a Windows developer, I want to learn how to create and run my first .NET MAUI app for Windows in Visual Studio.
 ---
 
 # Build your first .NET MAUI app for Windows
@@ -23,29 +24,29 @@ If you haven't already set up your environment for .NET MAUI development, please
 
 1. Launch Visual Studio, and in the start window click **Create a new project** to create a new project:
 
-![Create a new project.](images/hello-maui-new-project.png)
+   ![Create a new project.](images/hello-maui-new-project.png)
 
-2. In the **Create a new project** window, select **MAUI** in the All project types drop-down, select the **.NET MAUI App** template, and click the **Next** button:
+1. In the **Create a new project** window, select **MAUI** in the All project types drop-down, select the **.NET MAUI App** template, and click the **Next** button:
 
-![.NET MAUI App template.](images/hello-maui-app-template.png)
+   ![.NET MAUI App template.](images/hello-maui-app-template.png)
 
-3. In the **Configure your new project** window, give your project a name, choose a location for it, and click the **Next** button:
+1. In the **Configure your new project** window, give your project a name, choose a location for it, and click the **Next** button:
 
-![Name the new project.](images/hello-maui-name-project.png)
+   ![Name the new project.](images/hello-maui-name-project.png)
 
-4. In the **Additional information** window, click the **Create** button:
+1. In the **Additional information** window, click the **Create** button:
 
-![Create new project.](images/hello-maui-addl-info-create.png)
+   ![Create new project.](images/hello-maui-addl-info-create.png)
 
-5. Wait for the project to be created, and for its dependencies to be restored:
+1. Wait for the project to be created, and for its dependencies to be restored:
 
-![Project is created.](images/hello-maui-project-created.png)
+   ![Project is created.](images/hello-maui-project-created.png)
 
-6. In the Visual Studio toolbar, press the Windows Machine button to build and run the app.
+1. In the Visual Studio toolbar, press the Windows Machine button to build and run the app.
 
-7. In the running app, press the **Click me** button several times and observe that the count of the number of button clicks is incremented:
+1. In the running app, press the **Click me** button several times and observe that the count of the number of button clicks is incremented:
 
-![Run a MAUI app for the first time.](images/hello-maui-first-run-app.png)
+   ![Run a MAUI app for the first time.](images/hello-maui-first-run-app.png)
 
 You just ran your first .NET MAUI app on Windows. In the next section, you'll learn how to add data binding and messaging features from the **MVVM Toolkit** to your app.
 
@@ -59,116 +60,114 @@ Now that you have your first .NET MAUI app running on Windows, let's add some MV
 
 1. Right-click the project in **Solution Explorer** and select **Manage NuGet Packages...** from the context menu.
 
-2. In the **NuGet Package Manager** window, select the **Browse** tab and search for **CommunityToolkit.MVVM**:
+1. In the **NuGet Package Manager** window, select the **Browse** tab and search for **CommunityToolkit.MVVM**:
 
-![CommunityToolkit.MVVM package.](images/hello-maui-mvvm-pkg.png)
+   ![CommunityToolkit.MVVM package.](images/hello-maui-mvvm-pkg.png)
 
-3. Add the latest stable version of the **CommunityToolkit.MVVM** package (version 8.0.0 or later) to the project by clicking **Install**.
+1. Add the latest stable version of the **CommunityToolkit.MVVM** package (version 8.0.0 or later) to the project by clicking **Install**.
 
-4. Close the **NuGet Package Manager** window after the new package has finished installing.
+1. Close the **NuGet Package Manager** window after the new package has finished installing.
 
-5. Right-click the project again and select **Add | Class** from the context menu.
+1. Right-click the project again and select **Add | Class** from the context menu.
 
-6. In the **Add New Item** window that appears, name the class `MainViewModel` and click **Add**:
+1. In the **Add New Item** window that appears, name the class `MainViewModel` and click **Add**:
 
-![Add MainViewModel class.](images/hello-maui-add-vm.png)
+   ![Add MainViewModel class.](images/hello-maui-add-vm.png)
 
-7. The `MainViewModel` class will be the data binding target for the `MainPage`. Update it to inherit from `ObservableObject` in the `CommunityToolkit.Mvvm.ComponentModel` namespace This will also require updating the class to be `public` and `partial`.
+1. The `MainViewModel` class will be the data binding target for the `MainPage`. Update it to inherit from `ObservableObject` in the `CommunityToolkit.Mvvm.ComponentModel` namespace This will also require updating the class to be `public` and `partial`.
 
-8. The `MainViewModel` class will contain the following code. The `CountChangedMessage` record defines a message that is sent each time the Click me button is clicked, notifying the view of the change. The [ObservableProperty](/dotnet/communitytoolkit/mvvm/generators/observableproperty) and [RelayCommand](/dotnet/communitytoolkit/mvvm/generators/relaycommand) attributes added to the `message` and `IncrementCounter` members are source generators provided by the MVVM Toolkit to create the MVVM boilerplate code for `INotifyPropertyChanged` and `IRelayCommand` implementations. The `IncrementCounter` method's implementation contains the logic from `OnCounterClicked` in MainPage.xaml.cs, with a change to send a message with the new counter message. We will be removing that code-behind code later.
+1. The `MainViewModel` class will contain the following code. The `CountChangedMessage` record defines a message that is sent each time the Click me button is clicked, notifying the view of the change. The [ObservableProperty](/dotnet/communitytoolkit/mvvm/generators/observableproperty) and [RelayCommand](/dotnet/communitytoolkit/mvvm/generators/relaycommand) attributes added to the `message` and `IncrementCounter` members are source generators provided by the MVVM Toolkit to create the MVVM boilerplate code for `INotifyPropertyChanged` and `IRelayCommand` implementations. The `IncrementCounter` method's implementation contains the logic from `OnCounterClicked` in MainPage.xaml.cs, with a change to send a message with the new counter message. We will be removing that code-behind code later.
 
-``` csharp
-using CommunityToolkit.Mvvm.ComponentModel;
-using CommunityToolkit.Mvvm.Input;
-using CommunityToolkit.Mvvm.Messaging;
-
-namespace MauiOnWindows
-{
-    public sealed record CountChangedMessage(string Text);
-
-    public partial class MainViewModel : ObservableObject
+    ``` csharp
+    using CommunityToolkit.Mvvm.ComponentModel;
+    using CommunityToolkit.Mvvm.Input;
+    using CommunityToolkit.Mvvm.Messaging;
+    
+    namespace MauiOnWindows
     {
-        [ObservableProperty]
-        private string message = "Click me";
-
-        private int count;
-
-        [RelayCommand]
-        private void IncrementCounter()
+        public sealed record CountChangedMessage(string Text);
+    
+        public partial class MainViewModel : ObservableObject
         {
-            count++;
-
-            if (count == 1)
-                message = $"Clicked {count} time";
-            else
-                message = $"Clicked {count} times";
-
-            WeakReferenceMessenger.Default.Send(new CountChangedMessage(message));
+            [ObservableProperty]
+            private string message = "Click me";
+    
+            private int count;
+    
+            [RelayCommand]
+            private void IncrementCounter()
+            {
+                count++;
+    
+                // Pluralize the message if the count is greater than 1
+                message = count == 1 ? $"Clicked {count} time" : $"Clicked {count} times";
+    
+                WeakReferenceMessenger.Default.Send(new CountChangedMessage(message));
+            }
         }
     }
-}
-```
+    ```
 
-> [!NOTE]
-> You will need to update the namespace in the previous code to match the namespace in your project.
+   > [!NOTE]
+   > You will need to update the namespace in the previous code to match the namespace in your project.
 
-9. Open the **MainPage.xaml.cs** file for editing and remove the `OnCounterClicked` method and the `count` field.
+1. Open the **MainPage.xaml.cs** file for editing and remove the `OnCounterClicked` method and the `count` field.
 
-10. Add the following code to the `MainPage` constructor after the call to `InitializeComponenent()`. This code will receive the message sent by `IncrementCounter()` in the `MainViewModel` and will update the `CounterBtn.Text` property with the new message and announce the new text with the `SemanticScreenReader`:
+1. Add the following code to the `MainPage` constructor after the call to `InitializeComponent()`. This code will receive the message sent by `IncrementCounter()` in the `MainViewModel` and will update the `CounterBtn.Text` property with the new message and announce the new text with the `SemanticScreenReader`:
 
-``` csharp
-WeakReferenceMessenger.Default.Register<CountChangedMessage>(this, (r, m) =>
-{
-    CounterBtn.Text = m.Text;
-    SemanticScreenReader.Announce(m.Text);
-});
-```
+    ``` csharp
+    WeakReferenceMessenger.Default.Register<CountChangedMessage>(this, (r, m) =>
+    {
+        CounterBtn.Text = m.Text;
+        SemanticScreenReader.Announce(m.Text);
+    });
+    ```
 
-11. You will also need to add a `using` statement to the class:
+1. You will also need to add a `using` statement to the class:
 
-``` csharp
-using CommunityToolkit.Mvvm.Messaging;
-```
+    ``` csharp
+    using CommunityToolkit.Mvvm.Messaging;
+    ```
 
-12. In `MainPage.xaml`, add a namespace declaration to the `ContentPage` so the `MainViewModel` class can be found:
+1. In `MainPage.xaml`, add a namespace declaration to the `ContentPage` so the `MainViewModel` class can be found:
 
-``` xaml
-xmlns:local="clr-namespace:MauiOnWindows"
-```
+    ``` xaml
+    xmlns:local="clr-namespace:MauiOnWindows"
+    ```
 
-13. Add `MainViewModel` as the `BindingContext` for the `ContentPage`:
+1. Add `MainViewModel` as the `BindingContext` for the `ContentPage`:
 
-``` xaml
-<ContentPage.BindingContext>
-    <local:MainViewModel/>
-</ContentPage.BindingContext>
-```
+    ``` xaml
+    <ContentPage.BindingContext>
+        <local:MainViewModel/>
+    </ContentPage.BindingContext>
+    ```
 
-14. Update the `Button` on `MainPage` to use a `Command` instead of handling the `Clicked` event. The command will bind to the `IncrementCounterCommand` public property that is generated by the MVVM Toolkit's source generators:
+1. Update the `Button` on `MainPage` to use a `Command` instead of handling the `Clicked` event. The command will bind to the `IncrementCounterCommand` public property that is generated by the MVVM Toolkit's source generators:
 
-``` xaml
-<Button
-    x:Name="CounterBtn"
-    Text="Click me"
-    SemanticProperties.Hint="Counts the number of times you click"
-    Command="{Binding Path=IncrementCounterCommand}"
-    HorizontalOptions="Center" />
-```
+    ``` xaml
+    <Button
+        x:Name="CounterBtn"
+        Text="Click me"
+        SemanticProperties.Hint="Counts the number of times you click"
+        Command="{Binding Path=IncrementCounterCommand}"
+        HorizontalOptions="Center" />
+    ```
 
-15. Run the project again and observe that the counter is still incremented when you click the button:
+1. Run the project again and observe that the counter is still incremented when you click the button:
 
-![Click me button clicked three times.](images/hello-maui-mvvm-clicked-3-times.png)
+   ![Click me button clicked three times.](images/hello-maui-mvvm-clicked-3-times.png)
 
-16. While the project is running, try updating the "Hello, World!" message in the first Label to read "Hello, Windows!" in **MainPage.xaml**. Save the file and notice that [XAML Hot Reload](/dotnet/maui/xaml/hot-reload) updates the UI while the app is still running:
+1. While the project is running, try updating the "Hello, World!" message in the first Label to read "Hello, Windows!" in **MainPage.xaml**. Save the file and notice that [XAML Hot Reload](/dotnet/maui/xaml/hot-reload) updates the UI while the app is still running:
 
-![Hello World updated to Hello Windows with XAML Hot Reload.](images/hello-maui-xaml-hot-reload-edited.png)
+   ![Hello World updated to Hello Windows with XAML Hot Reload.](images/hello-maui-xaml-hot-reload-edited.png)
 
 ## Next steps
 
-Learn to build an app that displays [Microsoft Graph](/graph/) data for a user by leveraging the [Graph SDK](/graph/sdks/sdks-overview) in a [.NET MAUI for Windows tutorial](./tutorial-graph-api.md).
+Learn to build an app that displays [Microsoft Graph](/graph/) data for a user by leveraging the [Graph SDK](/graph/sdks/sdks-overview) in a [.NET MAUI for Windows tutorial](tutorial-graph-api.md).
 
-## Related topics
+## Related content
 
 [Resources for learning .NET MAUI](/dotnet/maui/get-started/resources)
 
-[Using the Microsoft Graph API with .NET MAUI on Windows](./tutorial-graph-api.md)
+[Using the Microsoft Graph API with .NET MAUI on Windows](tutorial-graph-api.md)