Merge pull request #6763 from ShawnJackson/get-started-nuget

ktoliver · web-flow · commit b05fa1e60564 · 2024-06-05T07:24:41.000-07:00
[AQ] edit pass: get-started-nuget
diff --git a/docs/artifacts/get-started-nuget.md b/docs/artifacts/get-started-nuget.md
@@ -1,6 +1,6 @@
 ---
-title: Get started with NuGet packages and Azure Artifacts
-description: How to use Azure Artifacts to publish and download NuGet packages from your feed.
+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.
 ms.service: azure-devops-artifacts
 ms.topic: quickstart
 ms.author: rabououn
@@ -11,75 +11,79 @@ monikerRange: '<= azure-devops'
 "recommendations": "true"
 ---
 
-# Get started with NuGet packages in Azure Artifacts
+# Quickstart: Get started with NuGet packages in Azure Artifacts
 
 [!INCLUDE [version-lt-eq-azure-devops](../includes/version-lt-eq-azure-devops.md)]
 
-Azure Artifacts enables developers to publish and download NuGet packages from different sources such as feeds and public registries. With Azure Artifacts, you can create feeds that can be either private, allowing you to share packages with your team and specific users, or public, enabling you to share them openly with anyone on the internet.
+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:
 
-In this article, you'll learn how to:
+* Private, so you can share packages with your team and specific users.
+* Public, so you can share packages openly with anyone on the internet.
 
-> [!div class="checklist"]    
+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.
 
 ## 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.
+* 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 [latest NuGet version](https://www.nuget.org/downloads).
 
-- Install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider#azure-artifacts-credential-provider).
+* Install the [Azure Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider#azure-artifacts-credential-provider).
 
-## Create Feed
+## <a name = "create-feed"></a> Create a feed
 
 [!INCLUDE [](includes/create-feed.md)]
 
-## 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. Sign in to your Azure DevOps organization, and then go to your project.
 
 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 navigation pane. If this is the first time using Azure Artifacts with Nuget.exe, ensure that you have installed all the prerequisites.
+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.
 
-    :::image type="content" source="./media/connect-to-feed-azure-devops-newnav.png" alt-text="A screenshot showing the connect to feed button.":::
+    :::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 instructions provided in the **Project setup** section to configure your *nuget.config* file and authenticate with Azure Artifacts.
+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="A screenshot showing how to set up your project.":::
+    :::image type="content" source="./media/project-setup.png" alt-text="Screenshot that shows onscreen instructions for setting up a project.":::
 
 ::: moniker-end
 
 ::: moniker range="azure-devops-2020 || azure-devops-2022"
 
-1. Sign in to your Azure DevOps server, and then navigate to your project.
+1. Sign in to your Azure DevOps server, and then go to your project.
 
 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.
+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.
 
-    :::image type="content" source="./media/connect-to-feed-nuget-server-2020.png" alt-text="A screenshot showing how to set up your NuGet project in Server 2020 and Server 2022.":::
+    :::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.":::
 
 ::: moniker-end
 
 ::: moniker range="azure-devops-2019"
 
-1. Sign in to your Azure DevOps server, and then navigate to your project.
+1. Sign in to your Azure DevOps server, and then go to your project.
 
 1. Select **Artifacts**, and then select your feed from the dropdown menu.
 
-1. Select **Connect to Feed**, and then select **NuGet** from the left.
+1. Select **Connect to Feed**, and then select **NuGet** from the left pane.
 
-1. Follow the instructions to add your package source URL to your *nuget.config*.
+1. Follow the instructions to add your package source URL to *nuget.config*.
 
-    :::image type="content" source="./media/connect-to-feed-nuget-server-2019.png" alt-text="A screenshot showing how to set up your NuGet project in Server 2019.":::
+    :::image type="content" source="./media/connect-to-feed-nuget-server-2019.png" alt-text="Screenshot that shows onscreen instructions for setting up a NuGet project in Azure DevOps Server 2019.":::
 
 ::: moniker-end
 
@@ -96,14 +100,14 @@ In this article, you'll learn how to:
 
 ## Publish packages  
 
-Run the following command to publish your package to your feed. You can enter any string for the *ApiKey* argument.
+To publish your package to your feed, run the following command. You can enter any string for the `ApiKey` argument.
 
 ```Command
 nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>
 ```
 
-## Related articles
+## 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)
diff --git a/docs/artifacts/includes/create-feed.md b/docs/artifacts/includes/create-feed.md
@@ -9,57 +9,74 @@ ms.date: 03/15/2024
 
 ::: moniker range="azure-devops"
 
-1. Sign in to your Azure DevOps organization, and then navigate to your project.
+1. Sign in to your Azure DevOps organization, and then go to your project.
 
-1. Select **Artifacts**, and then select **Create Feed** to create a new feed.
+1. Select **Artifacts**, and then select **Create Feed**.
 
-1. Enter a descriptive **Name** for your feed and define its **Visibility** (indicating who can view packages within the feed). Specify the **Scope** of your feed, and if you wish to include packages from public sources, mark the **Upstream sources** checkbox.
+1. For **Name**, enter a descriptive name for your feed.
+
+   For **Visibility**, select an option to indicate who can view packages within the feed.
+
+   If you want to include packages from public sources, select the checkbox under **Upstream sources**.
+
+   For **Scope**, specify whether the scope of your feed is the project or the organization.
 
 1. Select **Create** when you're done.
 
-    :::image type="content" source="../media/create-new-feed-azure-devops.png" alt-text="A screenshot showing how to create a new feed in Azure DevOps Services.":::
+    :::image type="content" source="../media/create-new-feed-azure-devops.png" alt-text="Screenshot that shows selections for creating a new feed in Azure DevOps Services.":::
+>>>>>>> main
 
 ::: moniker-end
 
 ::: moniker range="azure-devops-2022 || azure-devops-2020"
 
-1. Sign in to your Azure DevOps server, and then navigate to your project.
+1. Sign in to your Azure DevOps server, and then go to your project.
+
+2. Select **Artifacts**, and then select **Create Feed**.
 
-2. Select **Artifacts**, and then select **Create Feed** to create a new feed.
+3. For **Name**, enter a descriptive name for your feed.
 
-3. Enter a descriptive **Name** for your feed and define its **Visibility** (indicating who can view packages within the feed). Specify the **Scope** of your feed, and if you wish to include packages from public sources, mark the **Upstream sources** checkbox.
+   For **Visibility**, select an option to indicate who can view packages within the feed.
+
+   If you want to include packages from public sources, select the checkbox under **Upstream sources**.
+
+   For **Scope**, specify whether the scope of your feed is the project or the organization.
 
 ::: moniker-end
 
 ::: moniker range="azure-devops-2022"
 
 4. Select **Create** when you're done.
 
-    :::image type="content" source="../media/create-new-feed-server-2022.png" alt-text="A screenshot showing how to create a new feed in Azure DevOps 2022.":::
+    :::image type="content" source="../media/create-new-feed-server-2022.png" alt-text="Screenshot that shows selections for creating a new feed in Azure DevOps 2022.":::
 
 ::: moniker-end
 
 ::: moniker range="azure-devops-2020"
 
 4. Select **Create** when you're done.
 
-    :::image type="content" source="../media/create-new-feed-server-2020.png" alt-text="A screenshot showing how to create a new feed in Azure DevOps 2020.":::
+    :::image type="content" source="../media/create-new-feed-server-2020.png" alt-text="Screenshot that shows selections for creating a new feed in Azure DevOps 2020.":::
 
 ::: moniker-end
 
 ::: moniker range="azure-devops-2019"
 
-1. Sign in to your Azure DevOps server, and then navigate to your project.
+1. Sign in to your Azure DevOps server, and then go to your project.
 
 1. Select **Artifacts**, and then select **New feed**.
 
-1. Enter a descriptive **Name** for your feed and define its **Visibility** (indicating who can view packages within the feed). If you wish to include packages from public sources, select the **Use packages from public sources through this feed** option.
+1. For **Name**, enter a descriptive name for your feed.
+
+   For **Visibility**, select an option to indicate who can view packages within the feed.
+
+   If you want to include packages from public sources, select the **Use packages from public sources through this feed** option.
 
 1. Select **Create** when you're done.
 
-    :::image type="content" source="../media/create-new-feed-server-2019.png" alt-text="A screenshot showing how to create a new feed in Azure DevOps 2019.":::
+    :::image type="content" source="../media/create-new-feed-server-2019.png" alt-text="Screenshot that shows selections for creating a new feed in Azure DevOps 2019.":::
 
 ::: moniker-end
 
 > [!NOTE]
-> By default, newly created feeds have their project's *Build Service* set to **Feed and Upstream Reader (Collaborator)**.
+> By default, newly created feeds have their project's **Build Service** value set to **Feed and Upstream Reader (Collaborator)**.
diff --git a/docs/artifacts/includes/nuget/consume.md b/docs/artifacts/includes/nuget/consume.md
@@ -14,44 +14,44 @@ ms.date: 05/15/2024
 
 #### [Windows](#tab/windows/)
 
-1. In Visual Studio, select **Tools**, and then **Options**.
+1. In Visual Studio, select **Tools** > **Options**.
 
 1. Expand the **NuGet Package Manager** section, and then select **Package Sources**.
 
-1. Enter the feed's **Name** and the **Source** URL, and then select the green (+) sign to add a source.
+1. Enter the feed's **Name** value and the **Source** URL, and then select the green plus sign (+) to add a source.
 
 1. If you enabled upstream sources in your feed, clear the **nuget.org** checkbox.
 
 1. Select **OK** when you're done.
 
-    :::image type="content" source="../../media/vs-addsource.png" alt-text="A screenshot showing how to set up visual studio in Windows.":::
+    :::image type="content" source="../../media/vs-addsource.png" alt-text="A screenshot that shows selections for setting up Visual Studio in Windows.":::
 
 #### [macOS](#tab/macOS/)
 
 1. Create a [personal access token](../../../organizations/accounts/use-personal-access-tokens-to-authenticate.md).
 
-1. In visual studio, select **Preferences** from the menu bar.
+1. In Visual Studio, on the menu bar, select **Preferences**.
 
 1. Select **NuGet**, and then select **Sources**.
 
-1. Select **Add** and enter your feed's name, the source URL, a userName (any string), and your personal access token.
+1. Select **Add** and enter your feed's name, the source URL, a username (any string), and your personal access token.
 
 1. Select **OK** to save your source.
 
 1. If you enabled upstream sources in your feed, clear the **nuget.org** checkbox.
 
 1. Select **OK** when you're done.
 
-    :::image type="content" source="../../media/vs-mac-settings.png" alt-text="A screenshot showing how to set up visual studio in macOS.":::
+    :::image type="content" source="../../media/vs-mac-settings.png" alt-text="A screenshot that shows selections for setting up Visual Studio in macOS.":::
 
 ---
 
 #### 3. Download packages
 
-1. In Visual Studio, right-click on your project, and then select **Manage NuGet Packages**.
+1. In Visual Studio, right-click your project, and then select **Manage NuGet Packages**.
 
 1. Select **Browse**, and then select your feed from the **Package source** dropdown menu.
-    
-    :::image type="content" source="../../media/select-pkg-src.png" alt-text="A screenshot showing how to select your package source in Visual Studio.":::
+
+    :::image type="content" source="../../media/select-pkg-src.png" alt-text="Screenshot that shows selection of a package source in Visual Studio.":::
 
 1. Use the search bar to search for packages from your feed.
diff --git a/docs/artifacts/includes/nuget/nuget-consume-endpoint.md b/docs/artifacts/includes/nuget/nuget-consume-endpoint.md
@@ -9,24 +9,22 @@ ms.date: 05/15/2024
 
 ::: moniker range="azure-devops-2019"
 
-1. Sign in to your Azure DevOps server, and then navigate to your project.
+1. Sign in to your Azure DevOps server, and then go to your project.
 
-1. Select **Artifacts**, select your feed from the dropdown menu, and then select **Connect to feed**.
+1. Select **Artifacts**, select your feed from the dropdown menu, and then select **Connect to Feed**.
 
-1. Select **NuGet** from the left, and then copy your **Package source URL**.
+1. Select **NuGet** from the left pane, and then copy your **Package source URL** value.
 
 ::: moniker-end
 
 ::: moniker range="> azure-devops-2019"
 
-1. Sign in to your Azure DevOps, and then navigate to your project.
+1. Sign in to your Azure DevOps server, and then go to your project.
 
-1. Select **Artifacts**, select your feed from the dropdown menu, and then select **Connect to feed**.
+1. Select **Artifacts**, select your feed from the dropdown menu, and then select **Connect to Feed**.
 
-1. Select **Visual Studio** from the left navigation panel, and then copy your **Source** URL.
+1. Select **Visual Studio** from the left pane, and then copy your **Source** URL.
 
-    :::image type="content" source="../../media/nuget-visual-studio-newnav.png" alt-text="A screenshot showing the source URL.":::
+    :::image type="content" source="../../media/nuget-visual-studio-newnav.png" alt-text="Screenshot that shows a source URL.":::
 
 ::: moniker-end
-
-
