Merge branch 'main' into dependabot/github_actions/actions/stale-5.1.1

Author: ghogen

.github/workflows/stale-issues.yml

@@ -7,6 +7,7 @@ name: close-stale-issues
 on:
   schedule:
     - cron: "0 0 * * 4"
+  workflow_dispatch:
 
 permissions:
   contents: read

docs/code-quality/index.yml

@@ -1,10 +1,10 @@
 ### YamlMime:Landing
 
-title: Analyze code in Visual Studio
+title: Code analysis documentation - Visual Studio (Windows)
 summary: Visual Studio provides several different tools to analyze and improve code quality.
 
 metadata:
-  title: Code analyzers
+  title: Code analysis documentation - Visual Studio (Windows)
   description: Learn how Visual Studio can help you analyze code quality.
   ms.prod: visual-studio-windows
   ms.technology: vs-ide-code-analysis

docs/cross-platform/cross-platform-mobile-development-in-visual-studio.md

@@ -2,17 +2,17 @@
 title: "Cross-Platform Mobile Development in Visual Studio | Microsoft Docs"
 description: In this article, learn how you can build apps for Android, iOS, and Windows devices by using Visual Studio.
 titleSuffix: ""
-ms.custom: SEO-VS-2020
-ms.date: "10/17/2019"
+ms.custom: SEO-VS-2020, devdivchpfy22
+ms.date: 08/26/2022
 ms.technology: vs-ide-mobile
 ms.topic: "conceptual"
 ms.assetid: 8202717a-e990-45cf-b092-438651ccb38a
 author: therealjohn
 ms.author: johmil
-manager: crdun
 ms.workload:
   - "multiple"
 ---
+
 # Cross-platform mobile development in Visual Studio
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
@@ -25,7 +25,7 @@ If you want to build a game or immersive graphical app, install Visual Studio to
 
 ## Build an app for Android, iOS, and Windows (.NET Framework)
 
-![Devices](../cross-platform/media/homedevices.png "HomeDevices")
+:::image type="content" source="../cross-platform/media/homedevices.png" alt-text="Screenshot showing different types of home devices.":::
 
 With Visual Studio Tools for Xamarin, you can target Android, iOS, and Windows in the same solution, sharing code and even UI.
 
@@ -40,25 +40,25 @@ With Visual Studio Tools for Xamarin, you can target Android, iOS, and Windows i
 
 ### <a name="AndroidHTML"></a> Target Android, iOS, and Windows from a single code base
 
- You can build native apps for Android, iOS, and Windows by using C# or F# (Visual Basic is not supported at this time).  To get started, install Visual Studio, select the **Mobile Development with .NET** option in the installer.
+ You can build native apps for Android, iOS, and Windows by using C# or F# (Visual Basic isn't supported at this time). To get started, install Visual Studio, select the **Mobile Development with .NET** option in the installer.
 
- If you already have Visual Studio installed, re-run the **Visual Studio Installer** and select the same **Mobile Development with .NET** option for Xamarin (as above).
+ If you already have Visual Studio installed, rerun the **Visual Studio Installer** and select the same **Mobile Development with .NET** option for Xamarin (as shown earlier).
 
  When you're done, project templates appear in the **New Project** dialog box. The easiest way to find Xamarin templates is to just search on "Xamarin."
 
- Xamarin exposes the native functionality of Android, iOS, and Windows as .NET classes and methods. This means your apps have full access to native APIs and native controls, and they're just as responsive as apps written in the native platform languages.
+ Xamarin exposes the native functionality of Android, iOS, and Windows as .NET classes and methods. Your apps have full access to native APIs and native controls, and they're as responsive as apps written in the native platform languages.
 
- After you create a project, you'll leverage all of the productivity features of Visual Studio. For example, you'll use a designer to create your pages, and use IntelliSense to explore the native API's of the mobile platforms. When you're ready to run your app and see how it looks, you can use the Android SDK emulator and run Windows apps natively. You can also use tethered Android and Windows devices directly. For iOS projects, connect to a networked Mac and start the iOS emulator from Visual Studio, or connect to a tethered device.
+ After you create a project, you'll use all of the productivity features of Visual Studio. For example, you'll use a designer to create your pages, and use IntelliSense to explore the native APIs of the mobile platforms. When you're ready to run your app and see how it looks, you can use the Android SDK emulator and run Windows apps natively. You can also use tethered Android and Windows devices directly. For iOS projects, connect to a networked Mac and start the iOS emulator from Visual Studio, or connect to a tethered device.
 
 #### Design one set of pages that render across all devices by using Xamarin.Forms
 
- Depending on the complexity of your apps design, you might consider building it by using *Xamarin.Forms* templates in the **Mobile Apps** group of project templates. Xamarin.Forms is a UI toolkit that lets you create a single interface that you can share across Android, iOS, and Windows.  When you compile a Xamarin.Forms solution, you'll get an Android app, an iOS app, and a Windows app. For more details, see [Learn about mobile development with Xamarin](/xamarin/cross-platform/get-started/introduction-to-mobile-development/) and the [Xamarin.Forms documentation](/xamarin/xamarin-forms/).
+ Depending on the complexity of your apps design, you might consider building it by using *Xamarin.Forms* templates in the **Mobile Apps** group of project templates. Xamarin.Forms is a UI toolkit that lets you create a single interface that you can share across Android, iOS, and Windows.  When you compile a Xamarin.Forms solution, you'll get an Android app, an iOS app, and a Windows app. For more information, see [Learn about mobile development with Xamarin](/xamarin/cross-platform/get-started/introduction-to-mobile-development/) and the [Xamarin.Forms documentation](/xamarin/xamarin-forms/).
 
 #### <a name="ShareHTML"></a> Share code between Android, iOS, and Windows apps
 
  If you're not using Xamarin.Forms and choose to design for each platform individually, you can share most of your non-UI code between platform projects (Android, iOS, and Windows). This includes any business logic, cloud integration, database access, or any other code that targets the .NET Framework. The only code that you can't share is code that targets a specific platform.
 
- ![Share code between Windows, iOS, and Android UIs](../cross-platform/media/sharecode.png "ShareCode")
+ :::image type="content" source="../cross-platform/media/sharecode.png" alt-text="Screenshot showing Logical diagram showing share code between Windows, iOS, and Android UIs.":::
 
  You can share your code by using a shared project, a Portable Class Library project, or both. You might find that some code fits best in a shared project, and some code makes more sense inside a Portable Class Library project.
 
@@ -69,11 +69,11 @@ With Visual Studio Tools for Xamarin, you can target Android, iOS, and Windows i
 
 ### <a name="WindowsHTML"></a> Target Windows 10 devices
 
- ![Windows Devices](../cross-platform/media/windowsdevices.png "Windows Devices")
+ :::image type="content" source="../cross-platform/media/windowsdevices.png" alt-text="Screenshot of different types of Windows devices.":::
 
  If you want to create a single app that targets the full breadth of Windows 10 devices, create a universal Windows app. You'll design the app by using a single project and your pages will render properly no matter what device is used to view them.
 
- Start with a Universal Windows Platform (UWP) app project template. Design your pages visually, and then open them in a preview window to see how they appear for various types of devices. If you don't like how a page appears on a device, you can optimize the page to better fit the screen size, resolution, or various orientations such as landscape or portrait mode. You can do all of that by using intuitive tool windows and easily accessible menu options in Visual Studio. When you're ready to run your app and step through your code, you'll find all of the device emulators and simulators for different types of devices together in one drop-down list that is located on the **Standard** toolbar.
+ Start with a Universal Windows Platform (UWP) app project template. Design your pages visually, and then open them in a preview window to see how they appear for various types of devices. If you don't like how a page appears on a device, you can optimize the page to better fit the screen size, resolution, or various orientations such as landscape or portrait mode. You can do all of that by using intuitive tool windows and easily accessible menu options in Visual Studio. When you're ready to run your app, and step through your code, you'll find all of the device emulators and simulators for different types of devices together in one drop-down list that is located on the **Standard** toolbar.
 
 |**Learn more**|
 |--------------------|
@@ -85,25 +85,25 @@ With Visual Studio Tools for Xamarin, you can target Android, iOS, and Windows i
 
 ## Build an app for Android, iOS, and Windows (C++)
 
-![Use C&#43;&#43; to build for Android, iOS, and Windows](../cross-platform/media/cross_plat_cpp_intro_image.png "Cross_Plat_CPP_Intro_Image")
+:::image type="content" source="../cross-platform/media/cross_plat_cpp_intro_image.png" alt-text="Screenshot showing the use C&#43;&#43; to build for Android, iOS, and Windows.":::
 
  First, install Visual Studio and the **Mobile Development with C++** workload. Then, you can build a native activity application for Android, or an app that targets Windows or iOS. You can target Android, iOS, and Windows in the same solution if you want, and then share code between them by using a cross-platform static or dynamic shared library.
 
  If you need to build an app for Android that requires any sort of advanced graphics manipulation, such as a game, you can use C++ to do it. Start with the **Native Activity Application (Android)** project. This project has full support for the Clang toolchain.
 
- ![Native activity project template](../cross-platform/media/cross-plat_cpp_native.png "Native activity project template")
+ :::image type="content" source="../cross-platform/media/cross-plat_cpp_native.png" alt-text="Screenshot showing native activity project template.":::
 
  When you're ready to run your app and see how it looks, use the Android Emulator. It's fast, reliable, and easy to install and configure.
 
- You can also build an app that targets the full breadth of Windows 10 devices by using C++ and a Universal Windows Platform (UWP) app project template. Read more about this in the [Target Windows 10 devices](#WindowsHTML) section that appears earlier in this topic.
+ You can also build an app that targets the full breadth of Windows 10 devices by using C++ and a Universal Windows Platform (UWP) app project template. Read more about this in the [Target Windows 10 devices](#WindowsHTML) section that appears earlier in this article.
 
  You can share C++ code between Android, iOS, and Windows by creating a static or dynamic shared library.
 
- ![Static and dynamic shared libraries](../cross-platform/media/cross_plat_cpp_libraries.png "Static and dynamic shared libraries")
+ :::image type="content" source="../cross-platform/media/cross_plat_cpp_libraries.png" alt-text="Screenshot showing static and dynamic shared libraries.":::
 
- You can consume that library in a Windows, iOS, or Android project, like the ones described earlier in this section. You can also consume it in an app that you build by using Xamarin, Java, or any language that lets you invoke functions in an unmanaged DLL.
+ You can consume that library in a Windows, iOS, or Android project, like the ones described earlier in this article. You can also consume it in an app that you build by using Xamarin, Java, or any language that lets you invoke functions in an unmanaged DLL.
 
- As you write code in these libraries, you can use IntelliSense to explore the native APIs of the Android and Windows platforms. These library projects are fully integrated with the Visual Studio debugger so you can set breakpoints, step through code, and find and fix issues by using all of the advanced features of the debugger.
+ As you write code in these libraries, you can use IntelliSense to explore the native APIs of the Android and Windows platforms. These library projects are fully integrated with the Visual Studio debugger so you can set breakpoints. Step through code, and find and fix issues by using all of the advanced features of the debugger.
 
 |**Learn more**|
 |--------------------|
@@ -120,9 +120,9 @@ With Visual Studio Tools for Xamarin, you can target Android, iOS, and Windows i
 
  Visual Studio Tools for Unity is a free extension for Visual Studio that integrates Visual Studio's powerful code editing, productivity, and debugging tools with *Unity*, the popular cross-platform gaming/graphics engine and development environment for immersive apps that target Windows, iOS, Android, and other platforms including the web.
 
- ![VSTU development environment](../cross-platform/media/vstu_overview.png "Visual Studio Tools for Unity overview")
+ :::image type="content" source="../cross-platform/media/vstu_overview.png" alt-text="Screenshot showing the overview of Visual Studio Tools for Unity and development environment.":::
 
- With Visual Studio Tools for Unity (VSTU), you can use Visual Studio to write game and editor scripts in C# and then use its powerful debugger to find and fix errors. The latest release of VSTU brings support for Unity 2018.1 and includes syntax coloring for Unity's ShaderLab shader language, better synchronization with Unity, richer debugging, and improved code generation for the MonoBehavior wizard. VSTU also brings your Unity project files, console messages, and the ability to start your game into Visual Studio so you can spend less time switching to and from the Unity Editor while writing code.
+ With Visual Studio Tools for Unity (VSTU), you can use Visual Studio to write game and editor scripts in C# and then use its powerful debugger to find and fix errors. The latest release of VSTU brings support for Unity 2019.4 and includes syntax coloring for Unity's ShaderLab shader language, better synchronization with Unity, richer debugging, and improved code generation for the MonoBehavior wizard. VSTU also brings your Unity project files, console messages, and the ability to start your game into Visual Studio so you can spend less time switching to and from the Unity Editor while writing code.
 
 |**Learn more**|
 |--------------------|

docs/cross-platform/media/cross-plat_cpp_native.png

@@ -24,7 +24,11 @@ The features described here are applicable to C#, C++, Visual Basic, JavaScript,
 
 Breakpoints are a useful feature when you know the line of code or the section of code that you want to examine in detail at runtime. For more information on the different types of breakpoints, such as conditional breakpoints and function breakpoints, see [Using breakpoints](../debugger/using-breakpoints.md).
 
-To debug, you need to start your app with the debugger attached to the app process. **F5** (**Debug > Start Debugging**) is the most common way to do that. However, right now you may not have set any breakpoints to examine your app code, so we will do that first and then start debugging. Breakpoints are the most basic and essential feature of reliable debugging. A breakpoint indicates where Visual Studio should suspend your running code so you can take a look at the values of variables, or the behavior of memory, or whether or not a branch of code is getting run.
+To debug, you need to start your app with the debugger attached to the app process. To do this:
+
+- Press **F5** (**Debug > Start Debugging**), which is the most common method.
+
+However, right now you may not have set any breakpoints to examine your app code, so we will do that first and then start debugging. Breakpoints are the most basic and essential feature of reliable debugging. A breakpoint indicates where Visual Studio should suspend your running code so you can take a look at the values of variables, or the behavior of memory, or whether or not a branch of code is getting run.
 
 If you have a file open in the code editor, you can set a breakpoint by clicking in the margin to the left of a line of code.