Merge pull request #9594 from MicrosoftDocs/main638290192273155060syn…

…c_temp Repo sync for protected CLA branch
MicrosoftDocs · Aug 30, 2023 · 5264b1b · 5264b1b
2 parents 38ddbfb + 65c74c0
commit 5264b1b
Show file tree

Hide file tree

Showing 81 changed files with 149 additions and 138 deletions.
diff --git a/mac/accessibility-keyboard.md b/mac/accessibility-keyboard.md
@@ -10,7 +10,7 @@ ms.topic: how-to
 ---
 # Keyboard navigation in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Visual Studio for Mac is accessible by keyboard users using most common macOS keyboard shortcuts, as well as many that are specific to Visual Studio for Mac. Here, you learn about some basic keyboard commands for both, and how to set up Visual Studio for Mac keyboard shortcuts.
 

diff --git a/mac/accessibility.md b/mac/accessibility.md
@@ -8,9 +8,9 @@ ms.date: 02/23/2022
 ms.assetid: 2C4AAC2E-3B4A-4496-8BE0-1F5A7F81D1CA
 ms.topic: overview
 ---
-# Accessibility
+# Accessibility in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 There are a number of accessibility tools and features built right into macOS to assist you when using Visual Studio for Mac. These features include a high-contrast mode, keyboard navigation, and VoiceOver (the macOS screen reader).
 

diff --git a/mac/add-and-remove-project-items.md b/mac/add-and-remove-project-items.md
@@ -9,9 +9,9 @@ ms.custom: devdivchpfy22
 ms.assetid: 4071689D-1C21-42D7-8963-550E7BCB4B67
 ms.topic: how-to
 ---
-# Adding and removing project items
+# Adding and removing project items in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 You can add new project items to your project by right-clicking on the Project node in the **Solution Window** and browsing to **Add > New File**:
 

diff --git a/mac/asp-net-core.md b/mac/asp-net-core.md
@@ -11,9 +11,9 @@ no-loc: [Blazor, "Blazor WebAssembly"]
 ms.topic: how-to
 monikerRange: ">=vsmac-2022"
 ---
-# Getting Started with ASP.NET Core
+# Getting Started with ASP.NET Core in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Visual Studio for Mac makes it easy to develop your app's service with its support for the latest ASP.NET Core Web development platform. ASP.NET Core runs on the latest evolution of the .NET platform and runtime. It's been tuned for fast performance, factored for small install sizes, and reimagined to run on Linux and macOS, as well as Windows.
 

diff --git a/mac/azure-functions-lab.md b/mac/azure-functions-lab.md
@@ -11,7 +11,7 @@ ms.topic: how-to
 ---
 # Tutorial: Getting started with Azure Functions & Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 In this lab, you'll learn how to get started building Azure Functions using Visual Studio for Mac. You'll also integrate with Azure storage tables, which represent one of the many kinds of bindings and triggers available to Azure Functions developers.
 

diff --git a/mac/azure-functions.md b/mac/azure-functions.md
@@ -9,9 +9,9 @@ ms.technology: vs-ide-install
 ms.assetid: 25CD47A4-5B32-4734-8EF3-E24A02AABF29
 ms.topic: how-to
 ---
-# Introduction to Azure Functions
+# Introduction to Azure Functions in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Azure Functions is a way to create and run event-driven snippets of code –– functions –– in the cloud, without having to explicitly provision or manage infrastructure. For more information about Azure Functions, see the [Azure Functions documentation](/azure/azure-functions/).
 

diff --git a/mac/azure-workload.md b/mac/azure-workload.md
@@ -8,9 +8,9 @@ ms.author: dominicn
 manager: dominicn
 ms.date: 05/06/2018
 ---
-# Azure
+# Azure in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Visual Studio for Mac allows you to connect to Azure in a variety of ways:
 

diff --git a/mac/blazor.md b/mac/blazor.md
@@ -10,9 +10,9 @@ ms.assetid: D2717D3A-9225-40A8-8155-7D0143B2CA60
 no-loc: [Blazor, "Blazor WebAssembly"]
 ms.topic: how-to
 ---
-# Create Blazor web apps
+# Create Blazor web apps in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 This guide offers an introduction to creating your first Blazor web app. For more in-depth guidance, see [Introduction to ASP.NET Core Blazor](/aspnet/core/blazor/index).
 

diff --git a/mac/block-selection.md b/mac/block-selection.md
@@ -8,9 +8,9 @@ ms.date: 11/06/2018
 ms.topic: reference
 ms.assetid: E8E0831E-E076-44B1-A82A-A325382916A6
 ---
-# Block selection
+# Block selection in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Visual Studio for Mac makes it straightforward to select, cut, copy, and paste sections of your code. Rectangular blocks of code can be highlighted and selected by using the **Option + Drag** command on the code block. The formatting within this block selection is retained when pasting the block.
 

diff --git a/mac/build-actions.md b/mac/build-actions.md
@@ -8,9 +8,9 @@ ms.date: 09/18/2019
 ms.topic: conceptual
 ms.assetid: 5399BCB1-E317-4C7B-87B1-C531E985DE6E
 ---
-# Configure build actions
+# Configure build actions in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 All files in a Visual Studio for Mac project have a build action. The build action controls what happens to the file when the project is compiled. 
 

diff --git a/mac/building-and-cleaning-projects-and-solutions.md b/mac/building-and-cleaning-projects-and-solutions.md
@@ -9,9 +9,9 @@ ms.custom: devdivchpfy22
 ms.assetid: E4B6CB42-9FE2-43B9-93B7-BD4BD50518B1
 ms.topic: how-to
 ---
-# Building and cleaning projects and solutions
+# Building and cleaning projects and solutions in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Follow the steps in this article to learn how to build, rebuild, or clean your all or some of the projects in a solution.
 

diff --git a/mac/building-asp-net-core.md b/mac/building-asp-net-core.md
@@ -10,7 +10,7 @@ ms.topic: how-to
 ---
 # Building ASP.NET Core applications in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 ASP.NET Core is an open-source and cross-platform framework for building modern cloud-based internet connected applications, such as web apps and services, IoT apps, and mobile backends. ASP.NET Core apps can run on [.NET Core](https://www.microsoft.com/net/core/platform) or on the .NET Framework runtimes. It was architected to provide an optimized development framework for apps that are deployed to the cloud or run on-premises. It consists of modular components with minimal overhead, so you retain flexibility while constructing your solutions. You can develop and run your ASP.NET Core apps cross-platform on Windows, Mac, and Linux. ASP.NET Core is open source at [GitHub](https://github.com/aspnet/home).
 

diff --git a/mac/comments.md b/mac/comments.md
@@ -9,9 +9,9 @@ ms.custom: devdivchpfy22
 ms.assetid: 0FE5E929-1846-4F48-B5E3-70990FAF9504
 ms.topic: reference
 ---
-# Comments
+# Comments in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 While debugging or experimenting with code, you might want to comment blocks of code either temporarily or long term.
 

diff --git a/mac/compiling-and-building.md b/mac/compiling-and-building.md
@@ -11,7 +11,7 @@ ms.assetid: FB253757-DB00-4889-A6BF-E44722E25BD1
 ---
 # Compiling and building in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Visual Studio for Mac can be used to build applications and create assemblies during the development of your project. It's important to build your code often to allow you to quickly identify type mismatches, erroneous syntax, misspelled keywords, and other compile-time errors. By building then debugging, you can also find and fix run-time errors such as logic, IO, and divide-by-zero errors.
 

diff --git a/mac/configurations.md b/mac/configurations.md
@@ -8,9 +8,9 @@ ms.date: 09/18/2019
 ms.topic: conceptual
 ms.assetid: 78107CFA-9308-4293-A92A-9B552A259E15
 ---
-# Understanding build configurations
+# Understanding build configurations in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 You can store different configurations of solution and project properties to use in different kinds of builds during the development process. Projects created by Visual Studio for Mac using a template will typically include Debug and Release configurations that support debugging of an app and deployment of an app, respectively. 
 

diff --git a/mac/connected-services.md b/mac/connected-services.md
@@ -10,7 +10,7 @@ ms.topic: how-to
 ---
 # Connected Services walkthrough in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 The Connected Services workflow brings the Azure portal workflow into Visual Studio for Mac, so you don’t have to leave your project to add services.
 

diff --git a/mac/create-and-edit-configurations.md b/mac/create-and-edit-configurations.md
@@ -9,9 +9,9 @@ ms.assetid: CC1B72D6-12FF-4CCC-A9D4-00F2DC14589F
 ms.custom: video, devdivchpfy22
 ms.topic: how-to
 ---
-# Creating and editing build configurations
+# Creating and editing build configurations in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Build configurations give you precise control over a build allowing you to create configurations to cater to different testing and distribution situations. You can create build configurations for individual projects or on a solution-wide basis.
 

diff --git a/mac/create-new-projects.md b/mac/create-new-projects.md
@@ -9,9 +9,9 @@ ms.custom: devdivchpfy22
 ms.topic: how-to
 ms.assetid: 5880BB10-0A12-47E2-8A82-7A2D59C4D579
 ---
-# Create a new project
+# Create a new project in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 ## Opening the project creation dialog
 

diff --git a/mac/create-offline-installer.md b/mac/create-offline-installer.md
@@ -11,7 +11,7 @@ ms.assetid: 5CA4B8C1-2D01-46EA-A6B2-8573B324509B
 ---
 # Create an Offline Installer for Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 > [!IMPORTANT]
 > An offline installer feature is planned for future versions of Visual Studio for Mac.

diff --git a/mac/customizing-build-system.md b/mac/customizing-build-system.md
@@ -10,15 +10,15 @@ ms.assetid: 6958B102-8527-4B40-BC65-3505DB63F9D3
 ---
 # Customize the MSBuild system in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
-The Microsoft Build Engine is a platform for building applications. The engine, which is also known as MSBuild, was developed by Microsoft and allows for the building of .NET applications. The Mono framework also has its own implementation of Microsoft's Build Engine, called **xbuild**. At this time, however, xbuild has been phased out in favor of using MSBuild on all operating systems.
+The Microsoft Build Engine, which is also known as MSBuild, is a platform for building .NET applications.  The Mono framework also has its own implementation of Microsoft's Build Engine, called **xbuild**. At this time, however, xbuild has been phased out in favor of using MSBuild on all operating systems.
 
 **MSBuild** is used as the build system for projects in Visual Studio for Mac and works by taking a set of inputs, such as source files, and transforms them to outputs, such as executables. It achieves this output by invoking tools such as the compiler.
 
 ## MSBuild file
 
-MSBuild uses an XML file, called a project file, that defines the *Items* that are part of your project (such as image resources), and the *Properties* required to build your project. This project file will always have a file extension ending in `proj`, such as `.csproj` for C# projects.
+MSBuild uses an XML project file that defines the *Items* that are part of your project (such as image resources), and the *Properties* required to build your project. This project file always has a file extension ending in `proj`, such as `.csproj` for C# projects.
 
 ### Viewing the MSBuild file
 
@@ -40,7 +40,7 @@ All MSBuild files contain a mandatory root `Project` element, like so:
 </Project>
 ```
 
-Typically, the project will also import a `.targets` file. This file contains many of the rules that describe how to process and build the various files. The import usually appear towards the bottom of your `proj` file, and for C# projects look something like this:
+Typically, the project also imports a `.targets` file. This file contains many of the rules that describe how to process and build the various files. The import usually appear towards the bottom of your `proj` file, and for C# projects look something like this:
 
 ```xml
 <Import Project="$(MSBuildBinPath)\Microsoft.CSharp.targets" />
@@ -72,7 +72,7 @@ For example, the PropertyGroup for a simple console application might look like
 </PropertyGroup>
 ```
 
-Properties can be referred to from expressions using the `$()` syntax. For example, `$(Foo)` will be evaluated as the value of the `Foo` property. If the property has not been set, it will evaluate as an empty string, without any error.
+Properties can be referred to from expressions using the `$()` syntax. For example, `$(Foo)` is evaluated as the value of the `Foo` property. If the property has not been set, it evaluates as an empty string, without any error.
 
 #### Items
 
@@ -93,7 +93,7 @@ For example, the following code snippet creates the iOS Launch Screens. The Laun
   </ItemGroup>
  ```
 
- Item sets can be referred to from expressions using the `@()` syntax. For example, `@(BundleResource)` will be evaluated as the BundleResource item set, which means all of the BundleResource items. If there are no items of this type, it will be empty, without any error.
+ Item sets can be referred to from expressions using the `@()` syntax. For example, `@(BundleResource)` will be evaluated as the BundleResource item set, which means all of the BundleResource items. If there are no items of this type, it is empty, without any error.
 
 ## Resources for learning MSBuild
 

diff --git a/mac/customizing-the-ide.md b/mac/customizing-the-ide.md
@@ -8,9 +8,9 @@ ms.date: 03/03/2022
 ms.custom: devdivchpfy22
 ms.topic: how-to
 ---
-# Customizing the IDE
+# Customizing the IDE in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Visual Studio for Mac can be customized, allowing users to develop apps in an environment that meets their needs for both efficiency and aesthetics. This article explores the variety of ways that Visual Studio for Mac can be adapted to suit your needs.
 

diff --git a/mac/data-visualizations.md b/mac/data-visualizations.md
@@ -9,9 +9,9 @@ ms.technology: vs-ide-debug
 ms.topic: conceptual
 ms.assetid: 527E6BEC-EF15-4002-ACB5-62AE1C16F6B7
 ---
-# Data visualizations
+# Data visualizations in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Visual Studio for Mac includes UI support for the debugger, allowing visualizations of the values of a variable, field, or property while debugging. These data visualizers show an extended version of the data and allow developers to inspect known structures, for example showing the color of a color struct.
 

diff --git a/mac/debugging.md b/mac/debugging.md
@@ -12,7 +12,7 @@ ms.topic: conceptual
 ---
 # Debugging with Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 Visual Studio for Mac has debuggers with support for .NET Core, .NET Framework, Unity, and Xamarin applications.
 

diff --git a/mac/docker-multi-container.md b/mac/docker-multi-container.md
@@ -9,7 +9,7 @@ ms.topic: how-to
 ---
 # Create a Multi-Container App with Docker Compose for Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 In this tutorial, you'll learn how to manage more than one container and communicate between them when using Docker Compose in Visual Studio for Mac.
 
@@ -25,25 +25,25 @@ Looking for steps on the Windows version of Visual Studio, read [Tutorial: Creat
 1. Create a new solution by going to **File > New Solution**.
 1. Under **Web and Console > App** choose the **Web Application** template:
 ![Create a new ASP.NET application](media/docker-quickstart-1.png)
-1. Select the target framework. In this example we will use .NET Core 3.1:
+1. Select the target framework. In this example we use .NET Core 3.1:
 ![Set target framework](media/docker-quickstart-2.png)
 1. Enter the project details, such as Project Name (_DockerDemoFrontEnd_ in this example) and Solution Name (_DockerDemo_). The created project contains all the basics you need to build and run an ASP.NET Core web site.
 1. In the Solution Window, right click the DockerDemoFrontEnd project and select **Add > Add Docker Support**:
 ![Add docker support](media/docker-quickstart-3.png)
 
-Visual Studio for Mac will automatically add a new project to your solution called **docker-compose** and add a **Dockerfile** to your existing project.
+Visual Studio for Mac automatically adds a new project to your solution called **docker-compose** and add a **Dockerfile** to your existing project.
 
 ## Create an ASP.NET Core Web API and Add Docker Support
 
-Next we will create a second project which will act as our backend API. The **.NET Core API** template includes a controller that allows us to handle RESTful requests.
+Next, we create a second project that acts as our backend API. The **.NET Core API** template includes a controller that allows us to handle RESTful requests.
 
 1. Add a new project to the existing solution by right-clicking on the solution and choosing **Add > Add New Project**.
 1. Under **Web and Console > App** choose the **API** template.
-1. Select the target framework. In this example we will use .NET Core 3.1.
+1. Select the target framework. In this example, we use .NET Core 3.1.
 1. Enter the project details, such as Project Name (_MyWebAPI_ in this example).
 1. Once created, go to the Solution Window and right click the MyWebAPI project and select **Add > Add Docker Support**.
 
-The **docker-compose.yml** file in the **docker-compose** project will be automatically updated to include the API project alongside the existing Web App project. When we build and run the **docker-compose** project, each of these projects will be deployed to a separate Docker container.
+The **docker-compose.yml** file in the **docker-compose** project is automatically updated to include the API project alongside the existing Web App project. When we build and run the **docker-compose** project, each of these projects is deployed to a separate Docker container.
 
 ```yaml
 version: '3.4'

diff --git a/mac/docker-quickstart.md b/mac/docker-quickstart.md
@@ -9,7 +9,7 @@ ms.topic: how-to
 ---
 # Get started with Docker in Visual Studio for Mac
 
- [!INCLUDE [Visual Studio for Mac](~/includes/applies-to-version/vs-mac-only.md)]
+ [!INCLUDE [Retirement announcement for Visual Studio for Mac](includes/vsmac-retirement.md)]
 
 With Visual Studio for Mac, you can easily build, debug, and run containerized ASP.NET Core apps and publish them to Azure.