Merged main into live

Author: mijacobs

docs/artifacts/get-started-nuget.md

@@ -1,43 +1,31 @@
 ---
-title: "Quickstart: Get started with NuGet packages and Azure Artifacts"
-description: Learn how to use Azure Artifacts to publish and download NuGet packages from your feed.
+title: Publish and download NuGet packages with Azure Artifacts
+description: Learn how to use Azure Artifacts to publish and download NuGet packages.
 ms.service: azure-devops-artifacts
 ms.topic: quickstart
 ms.author: rabououn
 author: ramiMSFT
 ms.assetid: C5112218-DA7E-4016-986D-2D0F70DAFA44
-ms.date: 05/14/2024
+ms.date: 06/20/2025
 monikerRange: '>= azure-devops-2020'
 "recommendations": "true"
 ---
 
-# Quickstart: Get started with NuGet packages in Azure Artifacts
+# Publish and download NuGet packages with Azure Artifacts
 
-[!INCLUDE [version-gt-eq-2020](../includes/version-gt-eq-2020.md)]]
+[!INCLUDE [version-gt-eq-2020](../includes/version-gt-eq-2020.md)]
 
-Azure Artifacts enables developers to publish and download NuGet packages from sources such as feeds and public registries. With Azure Artifacts, you can create feeds that are either:
+Azure Artifacts enables developers to publish and download NuGet packages from feeds or public registries. Feeds can be either private, allowing you to share packages with specific users, or public, making your packages accessible to anyone on the internet.
 
-* Private, so you can share packages with your team and specific users.
-* Public, so you can share packages openly with anyone on the internet.
-
-In this quickstart, you learn how to:
-
-> [!div class="checklist"]
->
-> * Create a new feed.
-> * Set up your project and connect to your feed.
-> * Publish NuGet packages.
-> * Download packages from your feed.
+This article guides you through creating a feed, configuring your project, and publishing and downloading NuGet packages.
 
 ## Prerequisites
 
-* Create an Azure DevOps [organization](../organizations/accounts/create-organization.md) and a [project](../organizations/projects/create-project.md#create-a-project) if you haven't already.
-
-* Install the [latest NuGet version](https://www.nuget.org/downloads).
-
-* Install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider#azure-artifacts-credential-provider).
+| **Product**        | **Requirements**   |
+|--------------------|--------------------|
+| **Azure DevOps**   | - An Azure DevOps [organization](../organizations/accounts/create-organization.md).<br>- An Azure DevOps [project](../organizations/projects/create-project.md).<br> - Download and install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider).<br> - Install the [latest NuGet version](https://www.nuget.org/downloads). |
 
-## <a name = "create-feed"></a> Create a feed
+## Create a feed
 
 [!INCLUDE [](includes/create-feed.md)]
 
@@ -49,13 +37,11 @@ In this quickstart, you learn how to:
 
 1. Select **Artifacts**, and then select your feed from the dropdown menu.
 
-1. Select **Connect to Feed**, and then select **NuGet.exe** from the left pane. If this is your first time using Azure Artifacts with *Nuget.exe*, ensure that you installed all the prerequisites.
+1. Select **Connect to Feed**, and then select **NuGet.exe** from the left navigation pane. If this is your first time using Azure Artifacts with *Nuget.exe*, make sure you've installed the prerequisites.
 
-    :::image type="content" source="./media/connect-to-feed-azure-devops-newnav.png" alt-text="Screenshot that shows the button for connecting to a feed.":::
+1. Follow the provided instructions under the **Project setup** section to set up your *nuget.config* file and connect to your Azure Artifacts feed.
 
-1. Follow the instructions in the **Project setup** section to configure your *nuget.config* file and authenticate with Azure Artifacts.
-
-    :::image type="content" source="./media/project-setup.png" alt-text="Screenshot that shows onscreen instructions for setting up a project.":::
+    :::image type="content" source="./media/project-setup.png" alt-text="A screenshot displaying how to set up your project and connect to your feed in Azure DevOps Services.":::
 
 ::: moniker-end
 
@@ -65,42 +51,31 @@ In this quickstart, you learn how to:
 
 1. Select **Artifacts**, and then select your feed from the dropdown menu.
 
-1. Select **Connect to Feed**, and then select **NuGet.exe** from the left pane.
-
-1. Follow the instructions in the **Project setup** section to connect to your feed.
+1. Select **Connect to Feed**, and then select **NuGet.exe** from the left navigation pane.
 
-    :::image type="content" source="./media/connect-to-feed-nuget-server-2020.png" alt-text="Screenshot that shows onscreen instructions for setting up a NuGet project in Azure DevOps Server 2020 and 2022.":::
+1. Follow the provided instructions under the **Project setup** section to set up your *nuget.config* file and connect to your Azure Artifacts feed.
 
-::: moniker-end
-
-## Download packages
-
-[!INCLUDE [](includes/nuget/consume.md)]
-
-::: moniker range="azure-devops"
-
-> [!NOTE]
-> Using NuGet Package Explorer to search for packages in upstream sources is not supported.
+    :::image type="content" source="./media/connect-to-feed-nuget-server-2020.png" alt-text="A screenshot displaying how to set up your project and connect to your feed in Azure DevOps Server 2020 and 2022.":::
 
 ::: moniker-end
 
-## Publish packages  
+## Publish packages to your feed
 
-To publish your package to your feed, run the following command. You can enter any string for the `ApiKey` argument.
+To publish a package to your feed, run the following command. The `ApiKey` parameter is required, but you can use any arbitrary string as its value.
 
-```Command
+```CLI
 nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>
 ```
 
-**Examples:**
+#### Examples
 
-- Project-scoped feed:
+- **Project-scoped feed**:
 
     ```CLI
     nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
     ```
 
-- Organization-scoped feed:
+- **Organization-scoped feed**:
 
     ```CLI
     nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
@@ -109,8 +84,25 @@ nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>
 > [!NOTE]
 > The `ApiKey` is required, but you can use any arbitrary value when publishing to Azure Artifacts feeds.
 
+## Download packages from your feed
+
+To restore packages from your feed, run the following command in your project directory:
+
+```CLI
+nuget.exe restore
+```
+
+::: moniker range="azure-devops"
+
+> [!NOTE]
+> Searching for packages in upstream sources using the NuGet Package Explorer is not supported.
+
+::: moniker-end
+
 ## Related content
 
-* [Publish NuGet packages with Azure Pipelines (YAML/classic)](../pipelines/artifacts/nuget.md)
-* [Publish packages to NuGet.org](./nuget/publish-to-nuget-org.md)
-* [Use packages from NuGet Gallery](./nuget/upstream-sources.md)
+- [Publish NuGet packages with Azure Pipelines (YAML/classic)](../pipelines/artifacts/nuget.md)
+
+- [Publish packages to NuGet.org](nuget/publish-to-nuget-org.md)
+
+- [Use packages from NuGet Gallery](nuget/upstream-sources.md)

docs/artifacts/maven/project-setup-gradle.md

@@ -20,7 +20,7 @@ Azure Artifacts enables developers to manage project dependencies from a single
 
 | **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 [Gradle](https://docs.gradle.org/current/userguide/installation.html). |
+| **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-a-feed).<br> - Download and install [Gradle](https://docs.gradle.org/current/userguide/installation.html). |
 
 ## Project setup
 

docs/artifacts/maven/project-setup-maven.md

@@ -19,7 +19,7 @@ Azure Artifacts enables developers to publish and restore Maven packages from fe
 
 | **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](https://maven.apache.org/download.cgi) and [Install](https://maven.apache.org/install.html) Apache Maven. |
+| **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-a-feed).<br> - [Download](https://maven.apache.org/download.cgi) and [Install](https://maven.apache.org/install.html) Apache Maven. |
 
 ## Project setup
 

docs/artifacts/npm/publish.md

@@ -20,7 +20,7 @@ This article guides you through authenticating with your Azure Artifacts feed an
 
 | **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 Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm). |
+| **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-a-feed).<br> - [Download and install Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm). |
 
 ## Get the tools
 

docs/artifacts/npm/restore-npm-packages.md

@@ -17,7 +17,7 @@ This article guides you through authenticating with your Azure Artifacts feed an
 
 | **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). |
+| **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-a-feed). |
 
 ## Get the tools
 

docs/artifacts/nuget/dotnet-exe.md

@@ -19,7 +19,7 @@ This guide walks you through configuring your project to publish NuGet packages
 
 | **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). |
+| **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-a-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
 

docs/artifacts/nuget/dotnet-setup.md

@@ -19,7 +19,7 @@ Azure Artifacts enables developers to seamlessly publish packages to feeds and s
 
 | **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 the [.NET Core SDK](https://dotnet.microsoft.com/en-us/download). |
+| **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-a-feed).<br> - Download and install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider).<br> - Download and install the [.NET Core SDK](https://dotnet.microsoft.com/en-us/download). |
 
 ## Connect to a feed
 

docs/artifacts/nuget/install-nuget-packages-with-visual-studio.md

@@ -19,7 +19,7 @@ This article guides you through setting up your Visual Studio to install NuGet p
 
 | **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). |
+| **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-a-feed). |
 | **Other**          | - Download [Visual Studio](https://visualstudio.microsoft.com/downloads/). |
 
 ## Get the source URL

docs/artifacts/nuget/move-from-fileshares.md

@@ -80,7 +80,7 @@ If you want to replicate your existing file share permissions, make a note of th
 
 After completing the inventory of your current package sources, it's time to configure your feeds. In this step, we'll assume a one-to-one mapping of feeds to SMB shares.
 
-For each SMB share, follow the instructions to [Create a feed](../get-started-nuget.md#create-feed):
+For each SMB share, follow the instructions to [Create a feed](../get-started-nuget.md#create-a-feed):
 
 - Set the **Feed name** to match the name of your SMB share folder.
 

docs/artifacts/nuget/nuget-exe.md

@@ -19,7 +19,7 @@ Azure Artifacts enables developers to download NuGet packages from various sourc
 
 | **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> - Install the latest [NuGet version](https://www.nuget.org/downloads). |
+| **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-a-feed).<br> - Download and install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider).<br> - Install the latest [NuGet version](https://www.nuget.org/downloads). |
 
 ## Project setup