diff --git a/mac/accessibility-keyboard.md b/mac/accessibility-keyboard.md
index fd177257d16..ea1850c6ab6 100644
--- 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
index 2699a95607c..9990b5ec5f2 100644
--- 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
index d2853623a30..ed347f08d6a 100644
--- 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
index d4078e7a0eb..9a05b96d78f 100644
--- 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
index 2dd7a219ef2..8192af8c0c1 100644
--- 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
index 7c453e19f8d..0787395acda 100644
--- 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
index 69baadcf68c..0218fde60d9 100644
--- 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
index a649844c754..c83644a523b 100644
--- 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
index 08d5fd2e5c9..0e1dab0e59b 100644
--- 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
index 223584a0c1b..e3a0d8767d6 100644
--- 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
index 5541dd2ceac..1878bef3437 100644
--- 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
index 6b5e9f53e1e..11c14f8e6d4 100644
--- 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
index 6592e9cf9d6..b564043f9bd 100644
--- 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
index 008ae9f64f2..092a4ef6a29 100644
--- 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
index c08468a2a5a..beb843d132c 100644
--- 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
index fde173a4a44..aaafbd452b9 100644
--- 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
index 521e5afe0bd..a62eb7f0375 100644
--- 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
index c7cccb43f3d..f1df7ceaa5d 100644
--- 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
index 0095c1c4e22..ded0f252d83 100644
--- 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
index 5654455c2e7..0035212f8ba 100644
--- 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
index c116634f3cc..d3ba1fd2062 100644
--- 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
index e297c4c7eca..11ed896cea0 100644
--- 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
index 83e401fd214..620bf9f2aae 100644
--- 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
index 7a5155de0b6..285f63fbe3c 100644
--- 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
index 0740fbe6026..621e6bea37f 100644
--- 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.
 
diff --git a/mac/editor-behavior.md b/mac/editor-behavior.md
index 6ca337f17a3..6cfdf8e7c20 100644
--- a/mac/editor-behavior.md
+++ b/mac/editor-behavior.md
@@ -9,9 +9,9 @@ ms.custom: devdivchpfy22
 ms.topic: reference
 ms.assetid: 81EE4460-26EB-4BB0-9297-932E1F88E4B8
 ---
-# Editor Behavior
+# Editor Behavior 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)]
 
 Editor behaviors can be set to allow code to be formatted as it's written. These actions are set under **Visual Studio > Preferences > Text Editor > Behavior**, and some of the more commonly used functions are described below:
 
diff --git a/mac/editor-themes.md b/mac/editor-themes.md
index 0ed8b71c67e..781dcb28ab3 100644
--- a/mac/editor-themes.md
+++ b/mac/editor-themes.md
@@ -8,9 +8,9 @@ ms.date: 06/23/2023
 ms.assetid: 4C1B7952-CD45-4132-AD6B-01CF993D83F8
 ms.topic: reference
 ---
-# Editor themes
+# Editor themes 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)]
 
 Editor themes can be changed to any of the 10 color schemes provided by default in Visual Studio for Mac via the **Visual Studio > Preferences > Text Editor > Color Themes** menu options:
 
diff --git a/mac/editorconfig.md b/mac/editorconfig.md
index 4424273749c..9b1cdf8368a 100644
--- a/mac/editorconfig.md
+++ b/mac/editorconfig.md
@@ -9,9 +9,9 @@ ms.technology: vs-ide-install
 ms.assetid: 26A0DE31-2FBF-4E1B-99FB-083111AA1680
 ms.topic: reference
 ---
-# Creating and editing a custom EditorConfig file
+# Creating and editing a custom EditorConfig file 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)]
 
 In Visual Studio for Mac, you can add an [EditorConfig](https://editorconfig.org/) file to your project or solution to enforce consistent coding styles for everyone that works in the codebase. The settings declared in the EditorConfig file take precedence over global Visual Studio for Mac text editor settings. Using an EditorConfig file within your project or codebase allows you to set your coding style, preferences, and warnings for your project. Because the file is part of your codebase, it makes it easier for all users to adhere to the coding practices of a project, regardless of the IDE or code editor that they use.
 
diff --git a/mac/enable-subscription.md b/mac/enable-subscription.md
index 3266b334d03..c31f88d74cd 100644
--- a/mac/enable-subscription.md
+++ b/mac/enable-subscription.md
@@ -8,9 +8,9 @@ ms.date: 01/21/2020
 ms.topic: how-to
 ms.assetid: 898DFEB8-5757-4CCE-8AD2-8BC7706F5855
 ---
-# Enable Subscription
+# Enable Subscription 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 provides you with three different subscription levels to choose from, all accessible from one download:
 
diff --git a/mac/ide-tour.md b/mac/ide-tour.md
index 7e0cfbe27d6..ecfd8dbf4cf 100644
--- a/mac/ide-tour.md
+++ b/mac/ide-tour.md
@@ -11,7 +11,7 @@ ms.topic: overview
 ---
 # Visual Studio for Mac IDE tour
 
- [!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)]
 
 ::: moniker range="vsmac-2022"
 
diff --git a/mac/includes/vsmac-retirement.md b/mac/includes/vsmac-retirement.md
new file mode 100644
index 00000000000..38c5dffd9c4
--- /dev/null
+++ b/mac/includes/vsmac-retirement.md
@@ -0,0 +1,11 @@
+---
+title: include file
+ms.date: 08/30/2023
+ms.topic: include
+author: j-martens
+ms.author: jmartens
+---
+> [!IMPORTANT]
+> Visual Studio for Mac is scheduled for retirement on August 31st, 2024 in accordance with Microsoft’s [Modern Lifecycle Policy](/lifecycle/policies/modern). While you can continue to work with Visual Studio for Mac, there are several other options for developers on Mac such as the preview version of the new C# Dev Kit extension for VS Code.
+>  
+> [Learn more about support timelines and alternatives in this blog post](https://devblogs.microsoft.com/visualstudio/visual-studio-for-mac-retirement-announcement/).
diff --git a/mac/index.yml b/mac/index.yml
index ae017442d73..3a6566d46eb 100644
--- a/mac/index.yml
+++ b/mac/index.yml
@@ -1,14 +1,14 @@
 ### YamlMime:Hub
 
 title: Visual Studio for Mac documentation
-summary: Learn how to use Visual Studio for Mac to develop apps and games for iOS, Android, and web using .NET.
+summary: "Important! Visual Studio for Mac is scheduled for retirement on August 31st, 2024 in accordance with Microsoft’s Modern Lifecycle Policy. While you can continue to work with Visual Studio for Mac, there are several other options for developers on Mac such as the preview version of the new C# Dev Kit extension for VS Code."
 brand: visual-studio
 metadata:
   title: Visual Studio for Mac documentation | Microsoft Docs
   description: This article introduces the features of Visual Studio for Mac.
   author: heiligerdankgesang
   ms.author: dominicn
-  ms.date: 11/18/2021
+  ms.date: 08/18/2023
   ms.topic: hub-page
 
 highlightedContent:
diff --git a/mac/install-behind-a-firewall-or-proxy-server.md b/mac/install-behind-a-firewall-or-proxy-server.md
index 417577125f0..14570ebf474 100644
--- a/mac/install-behind-a-firewall-or-proxy-server.md
+++ b/mac/install-behind-a-firewall-or-proxy-server.md
@@ -11,7 +11,7 @@ ms.date: 01/10/2022
 ---
 # Install and use Visual Studio for Mac behind a firewall or proxy server
 
- [!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)]
 
 If you or your organization uses security measures such as a firewall or a proxy server, then there are domains that you might want to add to an "allow list" and ports and protocols that you might want to open so that you have the best experience when you install and use Visual Studio for Mac and Azure Services.
 
diff --git a/mac/install-preview.md b/mac/install-preview.md
index b629c6db857..7a0c717308b 100644
--- a/mac/install-preview.md
+++ b/mac/install-preview.md
@@ -12,7 +12,7 @@ ms.topic: how-to
 ---
 # Install a preview version of 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)]
 
 Before a new version of Visual Studio for Mac is officially released, it's available as a preview. The preview release gives you a chance to try out new features and get the latest bug fixes before they're fully incorporated into the product. You can learn more about what's new in the latest preview release by seeing the [Preview Release notes](https://aka.ms/vsmac-preview-release-notes).
 
diff --git a/mac/installation.md b/mac/installation.md
index c69ef3f6009..e7d83ae12ab 100644
--- a/mac/installation.md
+++ b/mac/installation.md
@@ -12,7 +12,7 @@ ms.topic: how-to
 ---
 # Install 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)]
 
 To start developing native, cross-platform .NET apps on macOS, install Visual Studio for Mac following the steps below.
 
diff --git a/mac/integrated-terminal.md b/mac/integrated-terminal.md
index fc15a7d2c96..adb95197a02 100644
--- a/mac/integrated-terminal.md
+++ b/mac/integrated-terminal.md
@@ -8,9 +8,9 @@ ms.date: 08/15/2022
 ms.topic: how-to
 ms.assetid: EFD53CE9-8174-4FE4-8863-2984D22FD921
 ---
-# Integrated Terminal
+# Integrated Terminal 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 open an integrated terminal window in Visual Studio for Mac, starting at the root of your solution. The terminal can be useful for different kinds of situations – running front-end tasks (for example: npm, ng, or vue), managing containers, running advanced git commands, executing Entity Framework commands, viewing dotnet CLI output, adding NuGet packages, and more. 
 
diff --git a/mac/intellisense.md b/mac/intellisense.md
index 9df10e8023e..2b55d26ec94 100644
--- a/mac/intellisense.md
+++ b/mac/intellisense.md
@@ -7,9 +7,9 @@ manager: dominicn
 ms.date: 08/16/2019
 ms.topic: reference
 ---
-# IntelliSense
+# IntelliSense 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)]
 
 IntelliSense provides several features to help enhance the experience of writing and editing code. For example, in addition to code completion, the IntelliSense engine also provides member lists, parameter info, and quick info.
 
diff --git a/mac/javascript-and-typescript-support.md b/mac/javascript-and-typescript-support.md
index 14042c98c17..feeecb76337 100644
--- a/mac/javascript-and-typescript-support.md
+++ b/mac/javascript-and-typescript-support.md
@@ -9,9 +9,9 @@ ms.technology: vs-ide-general
 ms.topic: how-to
 ms.assetid: 61432695-5B12-4257-B250-48D37EED106D
 ---
-# JavaScript and TypeScript support
+# JavaScript and TypeScript support 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 provides support for JavaScript and TypeScript through syntax highlighting, code formatting, and IntelliSense.
 
diff --git a/mac/keyboard-shortcuts.md b/mac/keyboard-shortcuts.md
index 18d2ffaa96a..cde28656806 100644
--- a/mac/keyboard-shortcuts.md
+++ b/mac/keyboard-shortcuts.md
@@ -10,7 +10,7 @@ ms.assetid: 48E06A61-7294-4EC8-A09D-1763C32AD910
 ---
 # Default keyboard shortcuts 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)]
 
 For information about keyboard accessibility, see [How to: Use Keyboard Navigation](~/accessibility-keyboard.md).
 
diff --git a/mac/launch-settings.md b/mac/launch-settings.md
index 82a3045da52..405399df5fd 100644
--- a/mac/launch-settings.md
+++ b/mac/launch-settings.md
@@ -8,9 +8,9 @@ ms.date: 05/02/2022
 ms.custom: devdivchpfy22
 ms.assetid: a556f9d7-86a8-408e-aa54-392584845889
 ---
-# launchSettings.json
+# launchSettings.json 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)]
 
 When you're developing ASP.NET Core projects, you can configure how your project should be started in development scenarios by customizing the contents of the launchSettings.json file. In Visual Studio for Mac, you can update this file by using the project options UI or by directly editing it. This file is the same configuration file that you can use when running Visual Studio on Windows or from the command line through `dotnet`. This file is stored in your project under the Properties folder.
 
diff --git a/mac/managing-app-resources.md b/mac/managing-app-resources.md
index 1682e713fa4..cc5095cba4d 100644
--- a/mac/managing-app-resources.md
+++ b/mac/managing-app-resources.md
@@ -8,9 +8,9 @@ ms.date: 05/06/2018
 ms.assetid: 61EAAB8F-3C32-4574-924F-CFC616604089
 ms.topic: overview
 ---
-# Managing app resources
+# Managing app resources 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)]
 
 App resource files, such as images, text files, and audio files, are necessary to your application but aren't compiled with the application. Each platform supported by Visual Studio for Mac handles these resources in different ways, as explained in the following guides:
 
diff --git a/mac/managing-references-in-a-project.md b/mac/managing-references-in-a-project.md
index 713bf0ef72f..a33b48a01a6 100644
--- a/mac/managing-references-in-a-project.md
+++ b/mac/managing-references-in-a-project.md
@@ -8,9 +8,9 @@ ms.date: 11/09/2020
 ms.assetid: 4AD51385-B0A8-4BA7-B2D4-BF2BD167A142
 ms.topic: overview
 ---
-# Managing References in a Project
+# Managing References in a 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)]
 
 Visual Studio for Mac provides two means of adding additional references to your project:
 
diff --git a/mac/managing-solutions-and-project-properties.md b/mac/managing-solutions-and-project-properties.md
index 230218906f4..7baaacda238 100644
--- a/mac/managing-solutions-and-project-properties.md
+++ b/mac/managing-solutions-and-project-properties.md
@@ -8,9 +8,9 @@ ms.date: 11/09/2020
 ms.topic: how-to
 ms.assetid: 75247EB8-323A-4AFD-A451-6703A03D5D1F
 ---
-# Managing Project and Solution Properties
+# Managing Project and Solution Properties 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)]
 
 ## Project options
 
diff --git a/mac/migrate-extensions.md b/mac/migrate-extensions.md
index b22c19baad2..835a9493db4 100644
--- a/mac/migrate-extensions.md
+++ b/mac/migrate-extensions.md
@@ -9,9 +9,9 @@ ms.technology: vs-ide-general
 ms.assetid: 5DA76197-7859-421f-AC45-401F22F5D794
 ms.topic: how-to
 ---
-# Troubleshooting: How do I release a new version of my existing extension?
+# Troubleshooting: How do I release a new version of my existing extension 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)]
 
 > [!IMPORTANT]
 > Currently, creating new extensions is not officially supported in Visual Studio 2019 for Mac.
diff --git a/mac/multi-caret-editing.md b/mac/multi-caret-editing.md
index 32e3b1d9233..ed6d46caf13 100644
--- a/mac/multi-caret-editing.md
+++ b/mac/multi-caret-editing.md
@@ -7,9 +7,9 @@ manager: dominicn
 ms.date: 08/19/2019
 ms.topic: reference
 ---
-# Multi-caret editing
+# Multi-caret editing 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)]
 
 Multi-caret editing allows you to add _n_ number of insertion points at a single time. When in multi-caret mode, you can add additional carets to your document with either mouse clicks or keyboard commands. The primary caret is a red cursor, and the secondary carets are in a light-blue color. Multi-caret edit mode is disabled with the `ESC` key.
 
diff --git a/mac/nuget-walkthrough.md b/mac/nuget-walkthrough.md
index 118601263b1..1d2fdfd2a96 100644
--- a/mac/nuget-walkthrough.md
+++ b/mac/nuget-walkthrough.md
@@ -10,7 +10,7 @@ ms.custom: conceptual, devdivchpfy22
 ---
 # Install and manage NuGet packages 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 NuGet Package Manager UI in Visual Studio for Mac allows you to easily install, uninstall, and update NuGet packages in projects and solutions. You can search for and add packages to your .NET Core, ASP.NET Core, and Xamarin projects.
 
diff --git a/mac/open-multiple-solutions.md b/mac/open-multiple-solutions.md
index d63c2c1c1d3..bd3954bcef9 100644
--- a/mac/open-multiple-solutions.md
+++ b/mac/open-multiple-solutions.md
@@ -11,7 +11,7 @@ ms.topic: how-to
 ---
 # Open multiple solutions or instances of 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)]
 
 By default, all applications on a Mac, including Visual Studio for Mac, are _single-instance_ apps. If the application you want to use is already open (illustrated by a dot under the icon in the dock), selecting the icon again opens the running instance, rather than a new one. If you require more instances of the application, you can prompt the system to open it for you, as described in the [next section](#open-a-second-instance-of-visual-studio-for-mac).
 
diff --git a/mac/project-multitargeting.md b/mac/project-multitargeting.md
index cdeb5be030d..4a6976188d9 100644
--- a/mac/project-multitargeting.md
+++ b/mac/project-multitargeting.md
@@ -8,9 +8,9 @@ ms.date: 12/12/2019
 ms.topic: how-to
 ms.assetid: 2a561af4-f1fe-493e-9a53-aa6d77d15498
 ---
-# Projects with multiple target frameworks
+# Projects with multiple target frameworks 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)]
 In Visual Studio for Mac, you can configure a Xamarin or .NET Core project to run on any one of several versions of the .NET Framework, and on any one of several system platforms. For example, you could target a project to run on both .NET Framework 4.6 and .NET Core 3.1. 
 
 For more information about target frameworks, see [Target frameworks](/dotnet/standard/frameworks).
diff --git a/mac/projects-and-solutions.md b/mac/projects-and-solutions.md
index a67e3649dee..ae8e231306c 100644
--- a/mac/projects-and-solutions.md
+++ b/mac/projects-and-solutions.md
@@ -10,7 +10,7 @@ ms.assetid: 8254505D-D96E-48BD-8A5E-CF6A917897EA
 ---
 # 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)]
 
 This article provides an overview of the *project* and *solution* concepts in Visual Studio for Mac.
 
diff --git a/mac/publish-app-svc.md b/mac/publish-app-svc.md
index 982628801c9..269282924b1 100644
--- a/mac/publish-app-svc.md
+++ b/mac/publish-app-svc.md
@@ -16,7 +16,7 @@ ms.workload:
 ---
 # Publish a Web app to Azure App Service using 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 use the Publish tool to publish ASP.NET Core apps to Azure App Service.
 
diff --git a/mac/publish-folder.md b/mac/publish-folder.md
index 27a51977a96..b6efe72de58 100644
--- a/mac/publish-folder.md
+++ b/mac/publish-folder.md
@@ -13,7 +13,7 @@ ms.topic: how-to
 ---
 # Publish to a folder using 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 use the Publish tool to publish .NET Core Console or ASP.NET Core apps to a folder.
 
diff --git a/mac/razor.md b/mac/razor.md
index 483fbd36bdf..842799595d1 100644
--- a/mac/razor.md
+++ b/mac/razor.md
@@ -9,9 +9,9 @@ ms.technology: vs-ide-general
 ms.assetid: F898CB6E-05ED-44CD-8DB6-427B2592CCC6
 ms.topic: how-to
 ---
-# Create Razor web apps
+# Create Razor 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 Razor web app. For more in-depth guidance, see [Introduction to Razor Pages in ASP.NET Core](/aspnet/core/razor-pages/index).
 
diff --git a/mac/refactoring.md b/mac/refactoring.md
index 06d9897b803..fa64f7e76b1 100644
--- a/mac/refactoring.md
+++ b/mac/refactoring.md
@@ -8,9 +8,9 @@ ms.date: 07/03/2020
 ms.assetid: C7782BF3-016F-4B41-8A81-85FC540A1A8F
 ms.topic: reference
 ---
-# Refactoring
+# Refactoring 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)]
 
 Refactoring code is a way to rearrange, restructure, and clarify existing code while ensuring that the overall behavior of the code doesn't change.
 
diff --git a/mac/report-a-problem.md b/mac/report-a-problem.md
index f3dedfe30fe..356efa2d3c1 100644
--- a/mac/report-a-problem.md
+++ b/mac/report-a-problem.md
@@ -10,7 +10,7 @@ ms.assetid: 1C7AC52E-754E-473F-A5B5-00C3A40DAACD
 ---
 # Report a problem or suggestions 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)]
 
 If you experience a problem with Visual Studio for Mac, we want to know about it. Here's how to report the problem to [Developer Community](https://aka.ms/feedback/report?space=41) so that we can diagnose and fix it.
 
diff --git a/mac/set-startup-projects.md b/mac/set-startup-projects.md
index b59531de226..c19af630390 100644
--- a/mac/set-startup-projects.md
+++ b/mac/set-startup-projects.md
@@ -9,9 +9,9 @@ ms.topic: how-to
 ms.prod: visual-studio-mac
 ms.assetid: fd354fff-ce6b-4505-a815-84a2311e39ba
 ---
-# Set multiple startup projects
+# Set multiple startup projects 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 specify that more than one project should be started when you debug or run your solution.
 
diff --git a/mac/set-up-git-repository.md b/mac/set-up-git-repository.md
index 1833196a0dc..c4ee9ed4167 100644
--- a/mac/set-up-git-repository.md
+++ b/mac/set-up-git-repository.md
@@ -8,9 +8,9 @@ ms.date: 06/30/2022
 ms.assetid: E992FA1D-B2AD-4A28-ADC6-47E4FC471060
 ms.topic: how-to
 ---
-# Set up a Git repository
+# Set up a Git repository 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)]
 
 Git is a distributed version control system that allows teams to work on the same documents simultaneously. This means there is a single server that contains all the files, but whenever a repository is checked out from this central source, the entire repository is cloned locally to your machine.
 
diff --git a/mac/show-imports.md b/mac/show-imports.md
index 9c5ef6e59d4..2a20e46c7b3 100644
--- a/mac/show-imports.md
+++ b/mac/show-imports.md
@@ -8,9 +8,9 @@ ms.date: 03/29/2019
 ms.assetid: C7782BF3-016F-4B41-8A81-85FC540A1A8F
 ms.topic: reference
 ---
-# Show import items
+# Show import 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)]
 
 Visual Studio for Mac can show all available types, even if they aren't imported to your project, in your IntelliSense completion list. By selecting an item which isn't imported, the correct `using` statement will be added to your source file.
 
diff --git a/mac/signing-in.md b/mac/signing-in.md
index e789e934a7a..77e438158b5 100644
--- a/mac/signing-in.md
+++ b/mac/signing-in.md
@@ -11,7 +11,7 @@ ms.topic: how-to
 ---
 # Sign in to 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)]
 
 Signing in to Visual Studio for Mac is how you [activate your subscription](enable-subscription.md). When you download Visual Studio for Mac, you'll always get the Community edition by default. If you have a [Professional or Enterprise license](https://visualstudio.microsoft.com/vs/compare/), you should sign in on first run to unlock any additional features. In addition you'll also get the following:
 
diff --git a/mac/snippets.md b/mac/snippets.md
index 449196c35a9..88ae30341aa 100644
--- a/mac/snippets.md
+++ b/mac/snippets.md
@@ -8,9 +8,9 @@ ms.date: 11/09/2020
 ms.topic: reference
 ms.assetid: 0FE27C0C-A861-4133-A74E-8D0505CF5342
 ---
-# Code snippets
+# Code snippets 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)]
 
 Code snippets, often referred to as _code templates_, are useful for efficient programming as they allow the insertion and editing of pre-written blocks of code. Using code snippets can be convenient for quickly adding common patterns, or even for learning new patterns when as the developer you are unsure of syntax. There are templates provided for C#, F#, HTML, XML, Python, and Razor.
 
diff --git a/mac/source-editor.md b/mac/source-editor.md
index d1387c6d733..968f5f6c5ee 100644
--- a/mac/source-editor.md
+++ b/mac/source-editor.md
@@ -8,9 +8,9 @@ ms.date: 05/06/2018
 ms.topic: reference
 ms.assetid: A018A314-C1C4-4F36-BCB6-2D434208FCFE
 ---
-# Source editor
+# Source editor 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)]
 
 A reliable source editor is essential for writing code succinctly and efficiently. Visual Studio for Mac provides a sophisticated source editor that is at the center of your interactions with the IDE. The source editor provides features that you might expect and need to do your work with ease: From the basics such a syntax highlighting, code snippets, and code folding, to the benefits of its Roslyn compiler integration, such as fully functional IntelliSense code completion.
 
diff --git a/mac/source-link.md b/mac/source-link.md
index c552451f80c..98a301ab7c9 100644
--- a/mac/source-link.md
+++ b/mac/source-link.md
@@ -9,9 +9,9 @@ ms.topic: conceptual
 ms.assetid: 4bcb8acf-db50-4bd8-a48e-86248f00c90b
 
 ---
-# Debugging into NuGet packages with Source Link
+# Debugging into NuGet packages with Source Link 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)]
 
 Source Link technology enables source code debugging of .NET assemblies from NuGet that ship .PDBs with links to source files. Source Link executes when developers create their NuGet package and embed source control metadata inside assemblies and the package. When Source Link is enabled in Visual Studio for Mac, the IDE will detect if source files are available for installed packages. Visual Studio for Mac will then offer to download them, which will allow you to step through the package code. Source Link also works with Mono Base Class Library code for Xamarin projects, allowing you to step into .NET Framework code as well. Source Link provides source control metadata to create a great debugging experience.
 
diff --git a/mac/supported-versions-net.md b/mac/supported-versions-net.md
index e80ffe2bacf..2eef049397c 100644
--- a/mac/supported-versions-net.md
+++ b/mac/supported-versions-net.md
@@ -8,9 +8,9 @@ ms.date: 06/12/2023
 ms.custom: devdivchpfy22
 ms.assetid: 8B8CEBE8-00DA-4AD1-8193-77F58B57F244
 ---
-# Supported versions of .NET
+# Supported versions of .NET 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 following table describes the versions of .NET Core supported by the stable and preview versions of Visual Studio 2022 for Mac:
 
diff --git a/mac/task-comments.md b/mac/task-comments.md
index 00337f801eb..64c0cd7b72b 100644
--- a/mac/task-comments.md
+++ b/mac/task-comments.md
@@ -8,9 +8,9 @@ ms.date: 11/09/2020
 ms.topic: reference
 ms.assetid: 562DCB46-D8FA-4DC4-AAEA-F274448C4CD2
 ---
-# Task Comments
+# Task 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)]
 ::: moniker range="vsmac-2022"
 > [!NOTE]
 > This feature is currently not available on Visual Studio 2022 for Mac and will be enabled again in an upcoming release.
diff --git a/mac/testing.md b/mac/testing.md
index f8ec703c76c..458b35bbee3 100644
--- a/mac/testing.md
+++ b/mac/testing.md
@@ -13,7 +13,7 @@ manager: dominicn
 ---
 # Testing tools 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 testing tools can help you and your team develop and sustain high standards of code excellence. Unit tests can be written and run using the Microsoft unit test framework (MSTest), xUnit, or NUnit.
 
diff --git a/mac/troubleshooting-no-templates.md b/mac/troubleshooting-no-templates.md
index e9db34a31a4..8c38ab3d661 100644
--- a/mac/troubleshooting-no-templates.md
+++ b/mac/troubleshooting-no-templates.md
@@ -8,9 +8,9 @@ manager: dominicn
 ms.date: 04/02/2019
 ms.assetid: 297D9094-B40F-4C1A-BF19-B14CB735003A
 ---
-# Troubleshooting: Why can I not see all available templates?
+# Troubleshooting: Why can I not see all available templates 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)]
 
 In the New Project Dialog you only see the templates of components that have been installed. If you are missing any following components, make sure the correct components are installed, as described below:
 
diff --git a/mac/troubleshooting.md b/mac/troubleshooting.md
index 62c88f11bd5..22ff24b06a2 100644
--- a/mac/troubleshooting.md
+++ b/mac/troubleshooting.md
@@ -8,9 +8,9 @@ manager: dominicn
 ms.date: 06/18/2019
 ms.assetid: CE860D79-E29E-4B93-B094-BE74B35FC1C2
 ---
-# Troubleshooting
+# Troubleshooting 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)]
 
 ## Viewing logs in Visual Studio for Mac
 
diff --git a/mac/tutorial-aspnet-core-vsmac-extending.md b/mac/tutorial-aspnet-core-vsmac-extending.md
index 1c461927c11..2ac04d59c81 100644
--- a/mac/tutorial-aspnet-core-vsmac-extending.md
+++ b/mac/tutorial-aspnet-core-vsmac-extending.md
@@ -8,9 +8,9 @@ ms.date: 10/18/2019
 ms.assetid: 047f5e36-f38e-4bf6-a1c5-3fde32978b7d
 ms.topic: how-to
 ---
-# Tutorial: Extending an existing ASP.NET Core web application
+# Tutorial: Extending an existing ASP.NET Core web application 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)]
 
 In these tutorials, you will be working with the [eShopOnWeb reference app](https://github.com/dotnet-architecture/eShopOnWeb). Each step consists of a video and a tutorial doc.
 
diff --git a/mac/tutorial-aspnet-core-vsmac-getting-started.md b/mac/tutorial-aspnet-core-vsmac-getting-started.md
index 4eee88e1b26..4a4d5d8b975 100644
--- a/mac/tutorial-aspnet-core-vsmac-getting-started.md
+++ b/mac/tutorial-aspnet-core-vsmac-getting-started.md
@@ -11,7 +11,7 @@ ms.topic: how-to
 ---
 # Tutorial: 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)]
 
 This tutorial consists of two steps; installing Visual Studio for Mac and building your first ASP.NET Core web application.
 
diff --git a/mac/uninstall-net-2019.md b/mac/uninstall-net-2019.md
index 01b6d43a73a..ec49b2caddf 100644
--- a/mac/uninstall-net-2019.md
+++ b/mac/uninstall-net-2019.md
@@ -10,7 +10,7 @@ ms.assetid: db2dc420-63d2-44ef-bdda-a351561dc900
 ---
 # Visual Studio for Mac 8.10 and .NET on Apple Silicon machines
 
- [!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)]
 
 On Apple Silicon machines (also known as M1, M2, or ARM), Visual Studio for Mac 8.10 does not support the .NET 6 Arm64 SDK. .NET 5 and .NET Core 3.1 x64 SDKs are supported. .NET 6 x64 SDK is required for building projects since the .NET 5 x64 and .NET Core 3.1 x64 SDKs are not supported for building on Apple Silicon machines.
 
diff --git a/mac/uninstall-net-2022.md b/mac/uninstall-net-2022.md
index 10a9eae2423..fb810626302 100644
--- a/mac/uninstall-net-2022.md
+++ b/mac/uninstall-net-2022.md
@@ -10,7 +10,7 @@ ms.assetid: 18f722bc-3d9d-4c75-9e77-d66b64784c8d
 ---
 # Visual Studio for Mac 17.0 Previews and .NET on Apple Silicon machines
 
- [!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)]
 
 On Apple Silicon machines (also known as M1, M2, or ARM) with older x64 SDKs installed, you'll need to remove all existing .NET installations in order to use the .NET 6 GA Arm64 SDK.  
 
diff --git a/mac/uninstall.md b/mac/uninstall.md
index 13d156df767..9e1a10083d2 100644
--- a/mac/uninstall.md
+++ b/mac/uninstall.md
@@ -12,7 +12,7 @@ ms.topic: how-to
 ---
 # Uninstall 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 use this guide to uninstall each component in Visual Studio for Mac individually by navigating to the relevant section. We recommend you use the scripts provided in the [Uninstall scripts](#uninstall-scripts) section to uninstall everything.
 
diff --git a/mac/unity-walkthrough.md b/mac/unity-walkthrough.md
index 4e92c17ec5e..78d7aea0c5d 100644
--- a/mac/unity-walkthrough.md
+++ b/mac/unity-walkthrough.md
@@ -12,7 +12,7 @@ ms.topic: how-to
 ---
 # Getting started building games with Unity 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)]
 
 Unity is a game engine that enables you to develop games in C#. This walkthrough shows how to get started developing and debugging Unity games using Visual Studio for Mac and the Visual Studio for Mac Tools for Unity extension alongside the Unity environment.
 
diff --git a/mac/update.md b/mac/update.md
index 89235a0bb00..6265c2d3f74 100644
--- a/mac/update.md
+++ b/mac/update.md
@@ -12,7 +12,7 @@ ms.assetid: DB8DC9FE-FF21-4061-8A96-3F9FC08A4F8F
 ---
 # Update 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 distributes updates for the IDE and supported frameworks regularly. These updates can be in the form of new features, improvements, and bug fixes.
 
diff --git a/mac/updater-troubleshooting.md b/mac/updater-troubleshooting.md
index 0870fb68645..45f153a041c 100644
--- a/mac/updater-troubleshooting.md
+++ b/mac/updater-troubleshooting.md
@@ -9,9 +9,9 @@ ms.date: 04/13/2019
 ms.technology: vs-ide-install
 ms.assetid: 31AF914A-C66B-4CD3-9429-39695E0E94AE
 ---
-# Troubleshooting: Updater has errors retrieving information
+# Troubleshooting: Updater has errors retrieving information 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)]
 
 On a rare occasion, you may see the error message "Error retrieving update information" displayed when you try to [update Visual Studio for Mac](update.md). If this happens, try the following steps to fix it:
 
diff --git a/mac/version-control.md b/mac/version-control.md
index 449ee3f1c2b..99b3642633d 100644
--- a/mac/version-control.md
+++ b/mac/version-control.md
@@ -8,9 +8,9 @@ manager: dominicn
 ms.date: 06/30/2022
 ms.assetid: 49917483-28AA-4598-A847-71F1F2E0DCB5
 ---
-# Version control & source control with Git
+# Version control & source control with Git 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)]
 
 Version control is a system for managing files over many different versions, and - in software development - is generally contributed to by many developers. The principal purpose of any version control system (_VCS_) is to find a solution that enables all users to work on the codebase at the same time.
 
diff --git a/mac/visual-studio-experience-improvement-program.md b/mac/visual-studio-experience-improvement-program.md
index 1c7be97b241..2bed8273d71 100644
--- a/mac/visual-studio-experience-improvement-program.md
+++ b/mac/visual-studio-experience-improvement-program.md
@@ -10,7 +10,7 @@ ms.assetid: 6F2ECF5A-E195-4890-8399-12A88C7D62FD
 ---
 # Visual Studio Customer Experience Improvement Program
 
- [!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 Visual Studio Customer Experience Improvement Program (VSCEIP) is a program designed to help Microsoft improve Visual Studio for Mac over time. This program collects information about computer hardware and how people use Visual Studio for Mac, without interrupting the users in their tasks at the computer. The information that is collected helps Microsoft identify which features to improve. This article describes how to opt in or out of the VSCEIP.
 
diff --git a/mac/vsmac-for-windows-users.md b/mac/vsmac-for-windows-users.md
index b057438a157..9560ecb759b 100644
--- a/mac/vsmac-for-windows-users.md
+++ b/mac/vsmac-for-windows-users.md
@@ -10,7 +10,7 @@ ms.assetid: 61CB6883-08CE-470F-8599-6F7570DB756E
 ---
 # Visual Studio for Mac for Windows users
 
- [!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)]
 
 Migrating from one operating system to another can be daunting. There are often subtle differences in cross-platform applications, from the user interface to the categorization of menu items. Here you'll learn the most common differences between Visual Studio for Mac and Visual Studio for Windows. You'll also learn a few different conventions between macOS and Windows.
 
diff --git a/mac/web-app-deployment.md b/mac/web-app-deployment.md
index a8595238dba..2a9af81f0be 100644
--- a/mac/web-app-deployment.md
+++ b/mac/web-app-deployment.md
@@ -8,9 +8,9 @@ manager: dominicn
 ms.date: 01/25/2019
 ms.assetid: d746292d-0570-424a-bf43-e16ab85bbf0d
 ---
-# ASP.NET Core Web App Deployment
+# ASP.NET Core Web App Deployment 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)]
 
 An important step in developing web applications is publishing (deployment). You can publish to a remote environment, so that others can use the application, or for testing purposes. Visual Studio for Mac offers two options to publish your application. Publish to Azure App Service enables you to publish your web application to Azure App Service. Publish to Folder enables you to publish your application to a folder.
 
diff --git a/mac/working-with-git.md b/mac/working-with-git.md
index dd58c45e22e..d37b7f6d0ad 100644
--- a/mac/working-with-git.md
+++ b/mac/working-with-git.md
@@ -11,9 +11,9 @@ ms.topic: how-to
 monikerRange: '>=vsmac-2022'
 
 ---
-# Working with Git
+# Working with Git 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)]
 
 Git is a distributed version control system that allows teams to work on the same documents simultaneously. This means that there is a central server that contains all the files, but when a repository is checked out from this central source, the entire repository is cloned to the local machine.
 
diff --git a/mac/workloads.md b/mac/workloads.md
index ee45bf401ca..88767c76fb9 100644
--- a/mac/workloads.md
+++ b/mac/workloads.md
@@ -10,7 +10,7 @@ ms.assetid: DDC39599-8C5D-4CB9-8DA5-229E085384CA
 ---
 # Visual Studio for Mac Workloads
 
- [!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 comes pre-installed with workloads for developing the following types of app:
 
diff --git a/mac/xamarin.md b/mac/xamarin.md
index 42a32f63ab2..c9514331b64 100644
--- a/mac/xamarin.md
+++ b/mac/xamarin.md
@@ -8,9 +8,9 @@ ms.date: 06/18/2019
 ms.assetid: 339F6051-5F90-48DC-8237-EBBC8A03A32B
 ms.topic: how-to
 ---
-# Xamarin mobile app development
+# Xamarin mobile app development 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)]
 
 First-class support for [Xamarin](/xamarin) allows you to develop rich native experiences for Android, macOS, iOS, tvOS, and watchOS. Xamarin.Forms cross-platform applications help you share XAML-based UI code between Android, iOS, and macOS without limiting access to native functionality.