Merge branch 'main' into alexbuckgit/docutune-autopr-docs-link-absolute-20220831-035716-3621420

Author: alexbuckgit

.github/workflows/stale-issues.yml

@@ -7,6 +7,7 @@ name: close-stale-issues
 on:
   schedule:
     - cron: "0 0 * * 4"
+  workflow_dispatch:
 
 permissions:
   contents: read
@@ -18,7 +19,7 @@ jobs:
       pull-requests: write  # for actions/stale to close stale PRs
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v5.1.1
+      - uses: actions/stale@v4.0.0
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           stale-issue-message: 'Thanks for sharing your feedback. We apologize for our delayed response. Due to the sheer volume of feedback in our repo, we have decided to prioritize the newest issues and are automatically closing our oldest issues with an Issues bot. If you believe your feedback is still actionable, then either respond directly in this issue or open a new documentation issue and we’ll review. If no activity occurs in the next 14 days, this issue will be closed.'

.github/workflows/stale.yml

@@ -13,7 +13,7 @@ jobs:
       pull-requests: write
 
     steps:
-    - uses: actions/stale@v5.1.1
+    - uses: actions/stale@v4.0.0
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         days-before-pr-stale: 14

docker/tutorials/tutorial-persist-data-layer-docker-app-with-vscode.md

@@ -66,7 +66,7 @@ The files created in one container aren't available in another.
    cat /data.txt
    ```
 
-   The terminal shows a number between 1 and 1000.
+   The terminal shows a number between 1 and 10000.
 
    To use the command line to see this result, get the container ID by using the `docker ps` command, and run the following command.
 

docs/azure/vs-azure-tools-azure-project-create.md

@@ -18,7 +18,6 @@ Visual Studio provides a project template that lets you create an [Azure cloud s
 ## Steps to create an Azure cloud service project in Visual Studio
 This section walks you through creating an Azure cloud service project in Visual Studio with one or more web roles.
 
-::: moniker range=">=vs-2019"
 1. From the start window, choose **Create a new project**.
 
 1. In the search box, type in *Cloud*, and then choose **Azure Cloud Service**.
@@ -28,8 +27,6 @@ This section walks you through creating an Azure cloud service project in Visual
 1. Give the project a name and choose **Create**.
 
    ![Give the project a name](./media/vs-azure-tools-azure-project-create/vs-2019/new-project-cloud-service-2.png)
-::: moniker-end
-
 1. In the **New Microsoft Azure Cloud Service** dialog, select the roles that you want to add, and choose the right arrow button to add them to your solution.
 
     ![Select new Azure cloud service roles](./media/vs-azure-tools-azure-project-create/new-cloud-service.png)

docs/code-quality/ca2240.md

@@ -69,7 +69,6 @@ The following example fixes the two previous violations by providing an override
 :::code language="vb" source="../snippets/visualbasic/VS_Snippets_CodeAnalysis/FxCop.Usage.ImplementISerializableCorrectly2/vb/FxCop.Usage.ImplementISerializableCorrectly2.vb" id="Snippet1":::
 ---
 
-
 ## Related rules
 
 - [CA2236: Call base class methods on ISerializable types](../code-quality/ca2236.md)

docs/code-quality/code-metrics-values.md

@@ -41,13 +41,9 @@ The following list shows the code metrics results that Visual Studio calculates:
 
 - **Class Coupling** - Measures the coupling to unique classes through parameters, local variables, return types, method calls, generic or template instantiations, base classes, interface implementations, fields defined on external types, and attribute decoration. Good software design dictates that types and methods should have high cohesion and low coupling. High coupling indicates a design that is difficult to reuse and maintain because of its many interdependencies on other types. For more information, see [Class coupling](code-metrics-class-coupling.md).
 
-::: moniker range=">=vs-2019"
-
 - **Lines of Source code** - Indicates the exact number of source code lines that are present in your source file, including blank lines. This metric is available starting in Visual Studio 2019 version 16.4 and Microsoft.CodeAnalysis.Metrics (2.9.5).
 
 - **Lines of Executable code** - Indicates the approximate number of executable code lines or operations. This is a count of number of operations in executable code. This metric is available starting in Visual Studio 2019 version 16.4 and Microsoft.CodeAnalysis.Metrics (2.9.5). The value is typically a close match to the previous metric, **Lines of Code**, which is the MSIL-instruction-based metric used in legacy mode.
-::: moniker-end
-
 
 ## Anonymous methods
 

docs/code-quality/disable-code-analysis.md

@@ -108,7 +108,6 @@ Examples:
 
 ::: moniker-end
 
-
 ## See also
 
 - [Suppress violations](use-roslyn-analyzers.md#suppress-violations)

docs/code-quality/how-to-configure-code-analysis-for-a-managed-code-project.md

@@ -41,25 +41,15 @@ In Visual Studio, you can choose from a list of code analysis [rule sets](../cod
 
 2. In the **Configuration** and **Platform** lists, choose the build configuration and target platform.
 
-
-::: moniker range=">=vs-2019"
-
 3. To run code analysis every time the project is built using the selected configuration, select **Run on build** in the **Binary analyzers** section. You can also run legacy code analysis manually, see [How to: Run Legacy Code Analysis Manually for Managed Code](how-to-run-legacy-code-analysis-manually-for-managed-code.md) for more details.
 
-::: moniker-end
-
 4. To view warnings from generated code, clear the **Suppress results from generated code** check box.
 
     > [!NOTE]
     > This option does not suppress code analysis errors and warnings from generated code when the errors and warnings appear in forms and templates. You can both view and maintain the source code for a form or a template, and it won't be overwritten.
 
-
-::: moniker range=">=vs-2019"
-
 5. In the **Active rules** list, do one of the following:
 
-::: moniker-end
-
    - Select the rule set that you want to use.
 
    - Select **\<Browse>** to find an existing custom rule set that is not in the list.

docs/code-quality/how-to-create-a-custom-rule-set.md

@@ -29,13 +29,8 @@ To create a custom rule set, you can open a built-in rule set in the **rule set
 
 2. On the **Properties** pages, select the **Code Analysis** tab.
 
-
-::: moniker range=">=vs-2019"
-
 3. In the **Active rules** drop-down list, do one of the following:
 
-::: moniker-end
-
    - Choose the rule set that you want to customize.
 
      \- or -
@@ -68,13 +63,8 @@ You can create a new rule set file from the **New File** dialog:
 
 2. On the **Properties** pages, select the **Code Analysis** tab.
 
-
-::: moniker range=">=vs-2019"
-
 3. Select **\<Choose multiple rule sets>** from **Active rules**.
 
-::: moniker-end
-
 4. In the **Add or Remove Rule Sets** dialog box, choose the rule sets you want to include in your new rule set.
 
    ![Add or remove rule sets dialog box](media/add-remove-rule-sets.png)

docs/code-quality/how-to-enable-and-disable-automatic-code-analysis-for-managed-code.md

@@ -26,9 +26,6 @@ To enable or disable legacy code analysis:
 
 3. Specify the build type in **Configuration** and the target platform in **Platform**. (Non-.NET Core/.NET Standard projects only.)
 
-
-::: moniker range=">=vs-2019"
-
 4. To enable or disable automatic code analysis, select or clear the **Run on build** check box in the **Binary analyzers** section.
 
    ![Run binary code analysis on build option in Visual Studio](media/run-on-build-binary-analyzers.png)
@@ -37,7 +34,5 @@ To enable or disable legacy code analysis:
 
    `<RunCodeAnalysis>false</RunCodeAnalysis>`
 
-::: moniker-end
-
 > [!NOTE]
 > Disabling binary code analysis on build does not affect [.NET Compiler Platform-based code analyzers](roslyn-analyzers-overview.md), which always execute at build if you installed them as a NuGet package. For information about disabling analysis from these analyzers, see [How to disable source code analysis](disable-code-analysis.md).

docs/code-quality/how-to-generate-code-metrics-data.md

@@ -88,7 +88,6 @@ The results are generated and the **Code Metrics Results** window is displayed.
 
 The results are generated and the **Code Metrics Results** window is displayed. To view the results details, expand the tree in the **Hierarchy**.
 
-
 ## Command-line code metrics
 
 You can generate code metrics data from the command line for C# and Visual Basic projects for .NET Framework, .NET Core, and .NET Standard apps. To run code metrics from the command line, install the [Microsoft.CodeAnalysis.Metrics NuGet package](#microsoftcodeanalysismetrics-nuget-package) or build the [Metrics.exe](#metricsexe) executable yourself.
@@ -146,8 +145,6 @@ Build succeeded.
 
 The generated XML output takes the following format:
 
-::: moniker range=">=vs-2019"
-
 ```xml
 <?xml version="1.0" encoding="utf-8"?>
 <CodeMetricsReport Version="1.0">
@@ -203,8 +200,6 @@ The generated XML output takes the following format:
 </CodeMetricsReport>
 ```
 
-::: moniker-end
-
 
 ### Metrics.exe
 
@@ -246,20 +241,14 @@ For more information, see [Enable generating code metrics in legacy mode](https:
 
 ### Previous versions
 
-::: moniker range=">=vs-2019"
 Visual Studio 2015 included a command-line code metrics tool that was also called *Metrics.exe*. This previous version of the tool did a binary analysis, that is, an assembly-based analysis. The newer version of the *Metrics.exe* tool analyzes source code instead. Because the newer *Metrics.exe* tool is source code-based, command-line code metrics results may be different to those generated by the Visual Studio IDE and by previous versions of *Metrics.exe*. Starting in Visual Studio 2019, the Visual Studio IDE analyzes source code like the command-line tool and the results should be the same.
 
-::: moniker-end
-
 
 The new command-line code metrics tool computes metrics even in the presence of source code errors, as long as the solution and project can be loaded.
 
 #### Metric value differences
 
-::: moniker range=">=vs-2019"
 Starting in Visual Studio 2019 version 16.4 and Microsoft.CodeAnalysis.Metics (2.9.5), `SourceLines` and `ExecutableLines` replace the previous `LinesOfCode` metric. For descriptions of the new metrics, see [Code metrics values](../code-quality/code-metrics-values.md). The `LinesOfCode` metric is available in legacy mode.
-::: moniker-end
-
 
 Other metrics such as `CyclomaticComplexity` and `MaintainabilityIndex` use the same formulas as previous versions of *Metrics.exe*, but the new tool counts the number of `IOperations` (logical source instructions) instead of intermediate language (IL) instructions. The numbers will be slightly different to those generated by the Visual Studio IDE and by previous versions of *Metrics.exe*.
 

docs/code-quality/how-to-synchronize-code-project-rule-sets-with-team-project-check-in-policy.md

@@ -34,13 +34,8 @@ You synchronize the code analysis settings for code projects to the check-in pol
 
 2. Click **Code Analysis**.
 
-
-::: moniker range=">=vs-2019"
-
 3. In the **Active rules** list, select the check-in policy rule set.
 
-::: moniker-end
-
 ## To specify a custom check-in policy rule set
 
 1. If necessary, perform a get operation on the rule set file that specifies the check-in policy.
@@ -49,13 +44,8 @@ You synchronize the code analysis settings for code projects to the check-in pol
 
 3. Click **Code Analysis**.
 
-
-::: moniker range=">=vs-2019"
-
 4. In the **Active rules** list, click **\<Browse>**.
 
-::: moniker-end
-
 5. In the **Open** dialog box, specify the check-in policy rule set file.
 
 ## To create a custom rule set for a code project

docs/code-quality/implementing-custom-code-analysis-check-in-policies-for-managed-code.md

@@ -109,13 +109,8 @@ You specify a project check-in policy rule set as the code analysis rule set of
 
 4. If necessary, click the appropriate options in the **Configuration** and **Platform** lists.
 
-
-::: moniker range=">=vs-2019"
-
 5. To run code analysis every time that the code project is built using the specified configuration, select **Run on build** in the **Binary analyzers** section.
 
-::: moniker-end
-
 6. In the **Run this rule set** list, click **\<Browse>**.
 
 8. Select the local version of the check-in policy rule set file.

docs/code-quality/in-source-suppression-overview.md

@@ -24,14 +24,10 @@ ms.workload:
 
 It is often useful to indicate that a warning is not applicable. Suppressing code analysis violations indicates team members the code was reviewed, and the warning can be suppressed. The following sections describe the different ways to suppress code analysis violations using the Visual Studio IDE.
 
-::: moniker range=">=vs-2019"
-
 ## Suppress violations using the EditorConfig file
 
 In an **EditorConfig file**, set the severity to `none`, for example, `dotnet_diagnostic.CA1822.severity = none`. To add an EditorConfig file, see [Add an EditorConfig file to a project](../ide/create-portable-custom-editor-options.md#add-and-remove-editorconfig-files).
 
-::: moniker-end
-
 ## Suppress violations in source code
 
 You can suppress violations in code using a preprocessor directive, the [#pragma warning (C#)](/dotnet/csharp/language-reference/preprocessor-directives#pragma-warning) or [Disable (Visual Basic)](/dotnet/visual-basic/language-reference/directives/disable-enable) directive to suppress the warning for only a specific line of code. Or, you can use the [SuppressMessage attribute](#in-source-suppression-and-the-suppressmessage-attribute).
@@ -42,13 +38,11 @@ You can suppress violations in code using a preprocessor directive, the [#pragma
 
   If you choose **in Source**, you see a preview of the preprocessor directive that will be added to your code.
 
-  ::: moniker range=">=vs-2019"
   :::image type="content" source="media/vs-2019/suppress-diagnostic-from-editor.png" alt-text="Suppress diagnostic from quick actions menu":::
 
   If you choose **in Source (attribute)**, you see a preview of the [SuppressMessage attribute](#in-source-suppression-and-the-suppressmessage-attribute) that will be added to your code.
 
   :::image type="content" source="media/vs-2019/suppress-diagnostic-from-editor-attribute.png" alt-text="Suppress diagnostic from quick actions menu using attribute":::
-  ::: moniker-end
 
 - From the **Error List**
 
@@ -75,12 +69,8 @@ The [global suppression file](#global-level-suppressions) uses the [SuppressMess
 
 - From the **code editor**, place the cursor in the line of code with the violation and press **Quick actions and refactorings** (or press **Ctrl**+**Period (.)**) to open the **Quick Actions** menu. Select **Suppress CAXXXX**, and then choose **in Suppression File**. You see a preview of the [global suppression file](#global-level-suppressions) that will be created or modified.
 
-::: moniker range=">=vs-2019"
-
 - From the **Analyze** menu, select **Analyze** > **Build and Suppress Active Issues** on the menu bar to suppress all current violations. Suppressing all current violations is sometimes referred to as "baselining".
 
-::: moniker-end
-
 
 ## Suppress violations using project settings
 
@@ -101,21 +91,15 @@ In C++/CLI, use the macros CA\_SUPPRESS\_MESSAGE or CA\_GLOBAL\_SUPPRESS_MESSAGE
 > [!NOTE]
 > You should not use in-source suppressions on release builds, to prevent shipping the in-source suppression metadata accidentally.
 
-
-::: moniker range=">=vs-2019"
-
 > [!NOTE]
 > If you migrate a project to Visual Studio 2019, you might suddenly be faced with a large number of code analysis warnings. If you aren't ready to fix the warnings, you can suppress all of them by selecting **Analyze** > **Build and Suppress Active Issues**.
 
-::: moniker-end
-
 ### SuppressMessage attribute
 
 When you select **Suppress** from the context or right-click menu of a code analysis warning in the **Error List**, a <xref:System.Diagnostics.CodeAnalysis.SuppressMessageAttribute> attribute is added either in your code or to the project's global suppression file.
 
 The <xref:System.Diagnostics.CodeAnalysis.SuppressMessageAttribute> attribute has the following format:
 
-
 ### [C#](#tab/csharp)
 ```csharp
 [Scope:SuppressMessage("Rule Category", "Rule Id", Justification = "Justification", MessageId = "MessageId", Scope = "Scope", Target = "Target")]

docs/code-quality/install-roslyn-analyzers.md

@@ -36,18 +36,13 @@ Visual Studio includes a core set of .NET Compiler Platform (*Roslyn*) analyzers
 
 ## To install VSIX analyzers
 
-
-::: moniker range=">=vs-2019"
-
 1. In Visual Studio, select **Extensions** > **Manage Extensions**.
 
    The **Manage Extensions** dialog box opens.
 
    > [!NOTE]
    > Alternatively, you can find and download the analyzer extension directly from [Visual Studio Marketplace](https://marketplace.visualstudio.com).
 
-::: moniker-end
-
 2. Expand **Online** in the left pane, and then select **Visual Studio Marketplace**.
 
 3. In the search box, type the name of the analyzer extension you want to install.
@@ -68,13 +63,8 @@ Visual Studio includes a core set of .NET Compiler Platform (*Roslyn*) analyzers
 
 8. Open Visual Studio again.
 
-
-::: moniker range=">=vs-2019"
-
 If you want to check whether the extension is installed, select **Extensions** > **Manage Extensions**. In the **Manage Extensions** dialog box, select the **Installed** category on the left, and then search for the extension by name.
 
-::: moniker-end
-
 ## Next steps
 
 > [!div class="nextstepaction"]

docs/code-quality/static-code-analysis-for-managed-code-overview.md

@@ -55,14 +55,9 @@ Public class MyClass
 
 For more information, see [Suppress warnings](../code-quality/in-source-suppression-overview.md).
 
-
-::: moniker range=">=vs-2019"
-
 > [!NOTE]
 > If you migrate a project to Visual Studio 2019, you might suddenly be faced with a large number of code analysis warnings. If you aren't ready to fix the warnings, you can suppress all of them by choosing **Analyze** > **Build and Suppress Active Issues**.
 
-::: moniker-end
-
 ## Run code analysis as part of check-in policy
 
 As an organization, you might want to require that all check-ins satisfy certain policies. In particular, you want to make sure that you follow these policies:

docs/code-quality/use-roslyn-analyzers.md

@@ -245,7 +245,6 @@ Following is the converted EditorConfig file:
 # Code files
 [*.{cs,vb}]
 
-
 dotnet_diagnostic.CA1001.severity = warning
 
 dotnet_diagnostic.CA1821.severity = warning

docs/code-quality/walkthrough-analyzing-managed-code-for-code-defects.md

@@ -58,15 +58,10 @@ This article steps you through the process of using legacy analysis to analyze y
 
 3. Choose the **Code Analysis** tab.
 
-
-::: moniker range=">=vs-2019"
-
 4. Make sure that **Run on build** is selected in the **Binary analyzers** section.
 
 5. From the **Active rules** drop-down list, select **Microsoft All Rules**.
 
-::: moniker-end
-
 6. On the **File** menu, click **Save Selected Items**, and then close the properties pages.
 
 7. On the **Build** menu, click **Build CodeAnalysisManagedDemo**.

docs/containers/container-launch-settings.md

@@ -13,8 +13,6 @@ ms.topic: reference
 
 In the *Properties* folder in an ASP.NET Core project, you can find the launchSettings.json file, which contains settings that control how your web app is started on your development machine. For detailed information on how this file is used in ASP.NET development, see [Use multiple environments in ASP.NET Core](/aspnet/core/fundamentals/environments?view=aspnetcore-2.2&preserve-view=true). In *launchSettings.json*, the settings in the **Docker** section are related to how Visual Studio handles containerized apps.
 
-::: moniker range=">=vs-2019"
-
 ```json
     "Docker": {
       "commandName": "Docker",
@@ -31,11 +29,8 @@ In the *Properties* folder in an ASP.NET Core project, you can find the launchSe
     }
 ```
 
-::: moniker-end
-
 The commandName setting identifies that this section applies to Container Tools. The following table shows the properties that can be set in this section:
 
-
 ::: moniker range="vs-2019"
 
 | Setting name         | Example                                               | Description                                                                                                             |