Merge branch 'main' into artifacts/362633

Author: ramiMSFT

.openpublishing.publish.config.json

@@ -62,12 +62,6 @@
       "branch": "main",
       "branch_mapping": {}
     },
-    {
-      "path_to_root": "snippets",
-      "url": "https://github.com/MicrosoftDocs/snippets-azure-devops-docs-pr",
-      "branch": "master",
-      "branch_mapping": {}
-    },
     {
       "path_to_root": "docs/reusable-content",
       "url": "https://github.com/MicrosoftDocs/reusable-content",

docs/artifacts/nuget/dotnet-exe.md

@@ -1,35 +1,32 @@
 ---
-title: Publish and restore NuGet packages with dotnet CLI
-description: How to connect to a feed and use the dotnet CLI to publish and restore NuGet packages.
+title: Publish NuGet packages with dotnet CLI
+description: Learn how to connect to a feed and use the dotnet CLI to publish NuGet packages.
 ms.assetid: CA2DCB9D-93FB-4E2D-B953-BF78D5687B35
 ms.service: azure-devops-artifacts
 ms.custom: devx-track-dotnet
-ms.topic: conceptual
-ms.date: 04/17/2024
+ms.topic: tutorial
+ms.date: 01/13/2025
 monikerRange: '>= azure-devops-2020'
-"recommendations": "true"
 ---
 
-# Publish and restore NuGet packages from the command line (dotnet)
+# Publish NuGet packages from the command line (dotnet)
 
 [!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)]
 
-Azure Artifacts enables you to publish and restore your NuGet packages to and from your feed, allowing you to share them with others according to your feed's visibility settings. This guide walks you through configuring your project to publish or restore packages using the dotnet command-line interface.
+This guide walks you through configuring your project to publish NuGet packages using the dotnet command-line interface.
 
 ## Prerequisites
 
-- An Azure DevOps organization and a project. Create an [organization](../../organizations/accounts/create-organization.md) or a [project](../../organizations/projects/create-project.md#create-a-project) if you haven't already.
+| **Product**        | **Requirements**                                                                                                                                                                                                                                                                                                                        |
+|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Azure DevOps**   | - An Azure DevOps [organization](../../organizations/accounts/create-organization.md).<br>- An Azure DevOps [project](../../organizations/projects/create-project.md).<br> - An Azure Artifacts [feed](../get-started-nuget.md#create-feed).<br> - Download and install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider).<br> - Download and install [.NET Core SDK (2.1.400+)](https://dotnet.microsoft.com/en-us/download). |
 
-- An Azure Artifacts feed. [Create a new feed](../get-started-nuget.md#create-feed) if you don't have one already.
-
-- Download and install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider).
-
-- Download and install [.NET Core SDK (2.1.400+)](https://dotnet.microsoft.com/en-us/download).
-
-## Connect to feed
+## Connect to a feed
 
 ::: moniker range="azure-devops"
 
+1. Sign in to your Azure DevOps organization, and then navigate to your project.
+
 1. Select **Artifacts**, and then select your feed from the dropdown menu.
 
 1. Select **Connect to feed**, and then select **dotnet** from the *NuGet* section on the left.
@@ -78,52 +75,56 @@ Azure Artifacts enables you to publish and restore your NuGet packages to and fr
 
 ::: moniker-end
 
-## Publish packages
+## Publish packages to a feed in the same organization
 
-Run the following command to publish a package to your feed. Replace the placeholders with the appropriate information:
+Run the following command to publish a package to your feed. Replace the placeholders with the appropriate values:
 
 ```CLI
 dotnet nuget push --source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --api-key <ANY_STRING> <PACKAGE_PATH> 
 ```
 
-**Example**: *dotnet nuget push --source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --api-key AZ bin/MyPackage.5.0.2.nupkg*
+**Example**: 
+
+```CLI
+dotnet nuget push --source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --api-key AZ bin/MyPackage.5.0.2.nupkg
+```
+
 
 > [!NOTE]
-> The `api-key` is only used as a placeholder.
+> The `api-key` is required, but you can provide any string as its value when publishing to an Azure Artifacts feed.
 
-## Publish packages from external sources
+## Publish packages to a feed in another organization
 
-1. Create a [personal access token](../../organizations/accounts/use-personal-access-tokens-to-authenticate.md) (PAT) with **packaging read and write** scope.
+To publish your NuGet packages to a feed in a different Azure DevOps organization, you must first create a personal access token (PAT) in the target organization.
 
-1. Replace the *<PERSONAL_ACCESS_TOKEN>* placeholder with your personal access token, and then run the following command to add your package source to your *nuget.config* file. This adds your PAT to your *nuget.config*. Make sure to store this file securely and not check it into source control.
+1. Navigate to the organization hosting the target feed and create a [personal access token](../../organizations/accounts/use-personal-access-tokens-to-authenticate.md) (PAT) with **Packaging** >  **Read & write** scope.
+
+1. Replace the *<PERSONAL_ACCESS_TOKEN>* placeholder with your personal access token, and then run the following command to add your package source to your *nuget.config* file. Ensure that this file is stored securely and is not checked into source control.
 
     ```CLI
     dotnet nuget add source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --name <SOURCE_NAME> --username <USER_NAME> --password <PERSONAL_ACCESS_TOKEN> --configfile <PATH_TO_NUGET_CONFIG_FILE>
     ```
 
-1. Publish your package:
+1. Run the following command to publish your package:
 
     ```CLI
     dotnet nuget push --source <SOURCE_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>
     ```
 
 **Example**: 
-*dotnet nuget add source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.config*
-*dotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkg*
 
-> [!NOTE]
-> If your organization is using a firewall or a proxy server, make sure you allow the [Azure Artifacts Domain URLs and IP addresses](../../organizations/security/allow-list-ip-url.md#azure-artifacts). 
+```CLI
+dotnet nuget add source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.config
 
-## Restore packages
+dotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkg
+```
 
-Run the following command to restore your packages. The `--interactive` flag is used to prompt the user for credentials:
+> [!NOTE]
+> If your organization is using a firewall or a proxy server, make sure you allow the [Azure Artifacts Domain URLs and IP addresses](../../organizations/security/allow-list-ip-url.md#azure-artifacts). 
 
-```CLI
-dotnet restore --interactive
-```
 
-## Related articles
+## Related content
 
-- [Connect to Azure Artifacts feeds (NuGet.exe)](./nuget-exe.md)
+- [Restore NuGet packages (dotnet)](restore-nuget-packages-dotnet.md)
 - [Publish packages with Azure Pipelines (YAML/Classic)](../../pipelines/artifacts/nuget.md)
-- [Use packages from NuGet Gallery](./upstream-sources.md)
+- [Use packages from NuGet.org](./upstream-sources.md)

docs/artifacts/nuget/restore-nuget-packages-dotnet.md

@@ -0,0 +1,88 @@
+---
+title: Restore NuGet packages with dotnet CLI
+description: Learn how to connect to a feed and use the dotnet CLI to restore NuGet packages.
+ms.service: azure-devops-artifacts
+ms.topic: tutorial
+ms.date: 01/13/2025
+monikerRange: '>= azure-devops-2020'
+---
+
+# Restore NuGet packages from the command line (dotnet)
+
+[!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)]
+
+This guide walks you through configuring your project and restoring your NuGet packages using the dotnet command-line interface.
+
+## Prerequisites
+
+| **Product**        | **Requirements**                                                                                                                                                                                                                                                                                                                        |
+|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Azure DevOps**   | - An Azure DevOps [organization](../../organizations/accounts/create-organization.md).<br>- An Azure DevOps [project](../../organizations/projects/create-project.md).<br> - An Azure Artifacts [feed](../get-started-nuget.md#create-feed).<br> - Download and install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider).<br> - Download and install [.NET Core SDK (2.1.400+)](https://dotnet.microsoft.com/en-us/download). |
+
+## Connect to a feed
+
+::: moniker range="azure-devops"
+
+1. Sign in to your Azure DevOps organization, and then navigate to your project.
+
+1. Select **Artifacts**, and then select your feed from the dropdown menu.
+
+1. Select **Connect to feed**, and then select **dotnet** from the *NuGet* section on the left.
+
+1. Create a *nuget.config* file in the same folder as your *csproj* or *sln* file. Copy the following XML snippet and paste it into your new file, replacing the placeholders with the relevant information:
+
+- Organization-scoped feed:
+
+    ```xml
+    <?xml version="1.0" encoding="utf-8"?>
+    <configuration>
+      <packageSources>
+        <clear />
+        <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
+      </packageSources>
+    </configuration>
+    ```
+
+- Project-scoped feed:
+
+    ```xml
+    <?xml version="1.0" encoding="utf-8"?>
+    <configuration>
+      <packageSources>
+        <clear />
+        <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
+      </packageSources>
+    </configuration>
+    ```
+::: moniker-end
+
+::: moniker range="azure-devops-2020 || azure-devops-2022"
+
+> [!NOTE]
+> dotnet isn't supported in Azure DevOps Server 2019.
+
+1. Sign in to your Azure DevOps server, and then navigate to your project.
+
+1. Select **Artifacts**, and then select your feed.
+
+1. Select **Connect to Feed**, and then select **dotnet** from the left navigation pane.
+
+1. Follow the instructions in the **Project setup** section to connect to your feed.
+
+    :::image type="content" source="../media/connect-to-feed-dotnet-server-2020-and-2022.png" alt-text="A screenshot showing how to connect to a feed with dotnet in Azure DevOps Server 2020 and 2022." lightbox="../media/connect-to-feed-dotnet-server-2020-and-2022.png":::
+
+::: moniker-end
+
+## Restore packages
+
+Run the following command to restore your packages. The `--interactive` flag is used to prompt the user for credentials:
+
+```CLI
+dotnet restore --interactive
+```
+
+## Related content
+
+- [Publish NuGet packages (dotnet)](dotnet-exe.md)
+- [Publish packages with Azure Pipelines (YAML/Classic)](../../pipelines/artifacts/nuget.md)
+- [Use packages from NuGet.org](./upstream-sources.md)

docs/artifacts/toc.yml

@@ -49,8 +49,11 @@
       href: nuget/restore-nuget-packages-nuget-exe.md
       displayName: nuget, restore
     - name: Publish NuGet packages (dotnet)
-      displayName: dotnet, artifacts, publish packages
       href: nuget/dotnet-exe.md
+      displayName: dotnet, artifacts, publish packages
+    - name: Restore NuGet packages (dotnet)
+      href: nuget/restore-nuget-packages-dotnet.md
+      displayName: dotnet, restore
     - name: Publish to a NuGet feed (YAML/Classic)
       displayName: nuget feed, nuget package, publish package, classic pipeline, yaml pipeline
       href: ../pipelines/artifacts/nuget.md?toc=/azure/devops/artifacts/toc.json

docs/artifacts/tutorials/share-packages-publicly.md

@@ -40,7 +40,7 @@ Public feeds are project-scoped feeds in a public project. Public feeds inherit
 #### [NuGet](#tab/nuget)
 
 - [Publish NuGet packages - (NuGet.exe)](../nuget/publish.md#publish-packages-to-a-feed-in-the-same-organization)
-- [Publish NuGet packages - (dotnet)](../nuget/dotnet-exe.md#publish-packages)
+- [Publish NuGet packages - (dotnet)](../nuget/dotnet-exe.md#publish-packages-to-a-feed-in-the-same-organization)
 
 #### [Npm](#tab/npm)
 

docs/boards/includes/feature-matrix-manage-queries.md

@@ -36,7 +36,7 @@ The following features provide support for working with query results, saving an
       - [Open and run a query](../queries/view-run-query.md)  
       - [Publish/refresh a query (Excel)](../backlogs/office/bulk-add-modify-work-items-excel.md)  
       - [Run REST API queries](/rest/api/azure/devops/wit/queries)  
-      - [Save queries](../queries/organize-queries.md#run-edit-and-save-a-query)  
+      - [Copy and save queries](../queries/organize-queries.md#copy-edit-and-save-a-query)  
       - [Set query permissions](../queries/set-query-permissions.md)  
    :::column-end:::  
 :::row-end:::

docs/boards/queries/organize-queries.md

@@ -42,11 +42,11 @@ Organize your personal or shared queries by adding a query folder. You can then
 [!INCLUDE [temp](../includes/open-queries.md)] 
 
 
-## Run, edit, and save a query  
+## Copy, edit, and save a query  
 
-The easiest way to define a query is to start with an existing shared query. 
-The following example shows how to find all closed bugs by modifying the 
-*Active Bugs* shared query provided with the Agile process template. Examples are based on the user interface provided through the web portal. 
+You can copy a query within the same project by selecting a query and saving it with a new name with the **Save as** option.  
+
+The easiest way to define a query is to start with an existing shared query. The following example shows how to find all closed bugs by modifying the *Active Bugs* shared query provided with the Agile process template. Examples are based on the user interface provided through the web portal. 
 
 #### [Browser](#tab/browser/)
 

docs/boards/queries/query-index-quick-ref.md

@@ -169,7 +169,7 @@ You can list work items based on the following criteria...
       ::: moniker range="azure-devops"
       - [Rename a query or query folder](organize-queries.md#rename-or-delete-a-query)) 
       - [Run a query](view-run-query.md) 
-      - [Save a query](organize-queries.md#run-edit-and-save-a-query) 
+      - [Copy and save a query](organize-queries.md#copy-edit-and-save-a-query) 
       - [Set query permissions](set-query-permissions.md) 
       - [Tree query](using-queries.md#use-a-work-item-tree-to-view-hierarchies)
       - [View a query](view-run-query.md) 
@@ -181,7 +181,7 @@ You can list work items based on the following criteria...
       ::: moniker range="< azure-devops"
       - [Rename a query or query folder](organize-queries.md#rename-or-delete-a-query) 
       - [Run a query](using-queries.md) 
-      - [Save a query](organize-queries.md#run-edit-and-save-a-query)
+      - [Copy and save a query](organize-queries.md#copy-edit-and-save-a-query)
       - [Save a query as a team favorite](organize-queries.md#save-a-query-as-a-team-favorite)  
       - [Set query permissions](set-query-permissions.md) 
       - [Tree query](using-queries.md#use-a-work-item-tree-to-view-hierarchies) 

docs/includes/free-tier.md

@@ -3,7 +3,7 @@ ms.topic: include
 ---
 
 - First five users free (Basic license)
-- **Azure Pipelines**
+- **Azure Pipelines:**
   - One [Microsoft-hosted CI/CD](../pipelines/licensing/concurrent-jobs.md#how-much-do-parallel-jobs-cost) (one concurrent job, up to 30 hours per month)
   - One self-hosted CI/CD concurrent job
 - **Azure Boards:** Work item tracking and boards

docs/includes/qa-get-vsts-support.md

@@ -1,10 +1,5 @@
 
 
-### How do I get help or support for Azure DevOps?
+#### Q: How do I get help or support for Azure DevOps?
 
-Choose from the following support options:
-
-* Report a problem with Azure DevOps on [Developer Community](https://developercommunity.visualstudio.com/spaces/21/index.html).
-* Provide a suggestion on [Developer Community](https://developercommunity.visualstudio.com/content/idea/post.html?space=21)
-* Get advice on [Stack Overflow](https://stackoverflow.com/questions/tagged/vs-team-services)
-* View the archives of the [Azure DevOps forum](https://social.msdn.microsoft.com/Forums/home?forum=TFService) on MSDN
+A: See [Get support and provide feedback](../user-guide/provide-feedback.md).

docs/organizations/accounts/change-organization-location.md

@@ -1,5 +1,5 @@
 ---
-title: Find or change the region of your organization
+title: Find or change the geography of your organization
 titleSuffix: Azure DevOps Services
 ms.custom: references_regions
 description: Find your organization's default location or update your organization's region in Azure DevOps.
@@ -8,7 +8,7 @@ ms.assetid: cc4fd0d6-b24f-48ec-8b90-8e5f18e18d65
 ms.topic: conceptual
 ms.author: chcomley
 author: chcomley
-ms.date: 10/22/2024
+ms.date: 01/15/2025
 monikerRange: 'azure-devops'
 ---
 
@@ -19,7 +19,7 @@ monikerRange: 'azure-devops'
 When you [create an organization](create-organization.md) in Azure DevOps, you can choose the geography where your organization gets hosted. You might select your organization's geography based on locality, network latency, or sovereignty requirements for data centers. The default location for your organization is determined by the closest [Microsoft Azure geography](https://azure.microsoft.com/regions) where Azure DevOps is available.
 
 > [!WARNING]
-> We're temporarily unable to process migration requests until January 13, 2025. We apologize for any inconvenience and appreciate your understanding. Migration requests will resume January 14.
+> We're temporarily unable to process migration requests. We apologize for any inconvenience and appreciate your understanding.
 
 ## Find your organization geography