Queue quickstart is ready

Author: spelluru

articles/service-bus-messaging/media/service-bus-dotnet-get-started-with-queues/azure-sign-button-visual-studio.png

@@ -3,7 +3,7 @@ title: Quickstart - Use Azure Service Bus queues from .NET app
 description: This quickstart shows you how to send messages to and receive messages from Azure Service Bus queues using the .NET programming language.
 ms.topic: quickstart
 ms.tgt_pltfrm: dotnet
-ms.date: 11/08/2022
+ms.date: 11/10/2022
 ms.devlang: csharp
 ms.custom: contperf-fy22q2, mode-api
 ---
@@ -37,20 +37,18 @@ If you're new to the service, see [Service Bus overview](service-bus-messaging-o
 
 [!INCLUDE [service-bus-create-queue-portal](./includes/service-bus-create-queue-portal.md)]
 
-
 [!INCLUDE [service-bus-passwordless-template-tabbed](../../includes/passwordless/service-bus/service-bus-passwordless-template-tabbed.md)]
 
 ## Launch Visual Studio and sign-in to Azure
 
 You can authorize access to the service bus namespace using the following steps:
 
-Select the **Sign in** button in the top right of Visual Studio.
-
-:::image type="content" source="..//storage/blobs/media/storage-quickstart-blobs-dotnet/sign-in-visual-studio-small.png" alt-text="Screenshot showing the button to sign in to Azure using Visual Studio.":::
+1. Select the **Sign in** button in the top right of Visual Studio.
 
-Sign-in using the Azure AD account you assigned a role to previously.
+    :::image type="content" source="./media/service-bus-dotnet-get-started-with-queues/azure-sign-button-visual-studio.png" alt-text="Screenshot showing the button to sign in to Azure using Visual Studio.":::
+2. Sign-in using the Azure AD account you assigned a role to previously.
 
-:::image type="content" source="..//storage/blobs/media/storage-quickstart-blobs-dotnet/sign-in-visual-studio-account-small.png" alt-text="Screenshot showing the account selection.":::
+    :::image type="content" source="..//storage/blobs/media/storage-quickstart-blobs-dotnet/sign-in-visual-studio-account-small.png" alt-text="Screenshot showing the account selection.":::
 
 
 ## Send messages to the queue
@@ -62,12 +60,11 @@ This section shows you how to create a .NET console application to send messages
 
 ### Create a console application
 
-1. Start Visual Studio 2022.
-1. Select **Create a new project**.
+1. In Visual Studio, select **File** -> **New** -> **Project** menu. 
 1. On the **Create a new project** dialog box, do the following steps: If you don't see this dialog box, select **File** on the menu, select **New**, and then select **Project**.
     1. Select **C#** for the programming language.
     1. Select **Console** for the type of the application.
-    1. Select **Console Application** from the results list.
+    1. Select **Console App** from the results list.
     1. Then, select **Next**.
 
         :::image type="content" source="./media/service-bus-dotnet-get-started-with-queues/new-send-project.png" alt-text="Image showing the Create a new project dialog box with C# and Console selected":::
@@ -81,10 +78,14 @@ This section shows you how to create a .NET console application to send messages
 ### [Passwordless](#tab/passwordless)
 
 1. Select **Tools** > **NuGet Package Manager** > **Package Manager Console** from the menu.
-1. Run the following command to install the **Azure.Messaging.ServiceBus** and **Azure.Identity** NuGet packages:
+1. Run the following command to install the **Azure.Messaging.ServiceBus** NuGet package.
 
     ```powershell
     Install-Package Azure.Messaging.ServiceBus
+    ```
+1. Run the following command to install the **Azure.Identity** NuGet package.
+
+    ```powershell
     Install-Package Azure.Identity
     ```
 
@@ -108,9 +109,9 @@ This section shows you how to create a .NET console application to send messages
     ### [Passwordless](#tab/passwordless)
 
     > [!IMPORTANT]
-    > Per the `TODO` comment, update the placeholder values in the code snippets with the values from the Service Bus you created.
+    > As per the `TODO` comment in the source code, update the placeholder values (`<NAMESPACE-NAME>` and `<QUEUE-NAME>`) in the code snippet with the values from the Service Bus you created.
 
-    * Creates a [ServiceBusClient](/dotnet/api/azure.messaging.servicebus.servicebusclient) object using the passwordless `DefaultAzureCredential` object. `DefaultAzureCredential` will automatically discover and use the credentials of your Visual Studio login to authenticate to Azure Service Bus.
+    * Creates a [ServiceBusClient](/dotnet/api/azure.messaging.servicebus.servicebusclient) object using the `DefaultAzureCredential` object. `DefaultAzureCredential` will automatically discover and use the credentials of your Visual Studio login to authenticate to Azure Service Bus.
     * Invokes the [CreateSender](/dotnet/api/azure.messaging.servicebus.servicebusclient.createsender) method on the [ServiceBusClient](/dotnet/api/azure.messaging.servicebus.servicebusclient) object to create a [ServiceBusSender](/dotnet/api/azure.messaging.servicebus.servicebussender) object for the specific Service Bus queue.
     * Creates a [ServiceBusMessageBatch](/dotnet/api/azure.messaging.servicebus.servicebusmessagebatch) object by using the [ServiceBusSender.CreateMessageBatchAsync](/dotnet/api/azure.messaging.servicebus.servicebussender.createmessagebatchasync) method.
     * Add messages to the batch using the [ServiceBusMessageBatch.TryAddMessage](/dotnet/api/azure.messaging.servicebus.servicebusmessagebatch.tryaddmessage).
@@ -290,14 +291,19 @@ In this section, you'll create a .NET console application that receives messages
 ### [Passwordless](#tab/passwordless)
 
 1. Select **Tools** > **NuGet Package Manager** > **Package Manager Console** from the menu.
-1. Run the following command to install the **Azure.Messaging.ServiceBus** and **Azure.Identity** NuGet packages:
+1. Select **QueueReceiver** for **Default project**. 
+
+    :::image type="content" source="media/service-bus-dotnet-get-started-with-queues/package-manager-console.png" alt-text="Screenshot showing QueueReceiver project selected in the Package Manager Console.":::
+1. Run the following command to install the **Azure.Messaging.ServiceBus** NuGet package.
 
     ```powershell
     Install-Package Azure.Messaging.ServiceBus
-    Install-Package Azure.Identity
     ```
+1. Run the following command to install the **Azure.Identity** NuGet package.
 
-    :::image type="content" source="media/service-bus-dotnet-get-started-with-queues/package-manager-console.png" alt-text="Screenshot showing QueueReceiver project selected in the Package Manager Console.":::
+    ```powershell
+    Install-Package Azure.Identity
+    ```
 
 ### [Connection String](#tab/connection-string)
 
@@ -380,6 +386,8 @@ In this section, you'll add code to retrieve messages from the queue.
     * Starts processing messages by invoking the [StartProcessingAsync](/dotnet/api/azure.messaging.servicebus.servicebusprocessor.startprocessingasync) on the `ServiceBusProcessor` object.
     * When user presses a key to end the processing, invokes the [StopProcessingAsync](/dotnet/api/azure.messaging.servicebus.servicebusprocessor.stopprocessingasync) on the `ServiceBusProcessor` object.
 
+    > [!IMPORTANT]
+    > Update placeholder values (`<NAMESPACE-NAME>` and `<QUEUE-NAME>`) in the code snippet with actual values you noted down earlier..
     
     ```csharp
     // The Service Bus client types are safe to cache and use as a singleton for the lifetime

articles/service-bus-messaging/service-bus-dotnet-get-started-with-queues.md

@@ -17,30 +17,42 @@ The following example assigns the `Azure Service Bus Data Owner` role to your us
 ### Azure built-in roles for Azure Service Bus
 For Azure Service Bus, the management of namespaces and all related resources through the Azure portal and the Azure resource management API is already protected using the Azure RBAC model. Azure provides the below Azure built-in roles for authorizing access to a Service Bus namespace:
 
-- [Azure Service Bus Data Owner](../../../articles/role-based-access-control/built-in-roles.md#azure-service-bus-data-owner): Enables data access to Service Bus namespace and its entities (queues, topics, subscriptions, and filters)
+- [Azure Service Bus Data Owner](../../../articles/role-based-access-control/built-in-roles.md#azure-service-bus-data-owner): Enables data access to Service Bus namespace and its entities (queues, topics, subscriptions, and filters). A member of this role can send and receive messages from queues or topics/subscriptions. 
 - [Azure Service Bus Data Sender](../../../articles/role-based-access-control/built-in-roles.md#azure-service-bus-data-sender): Use this role to give the send access to Service Bus namespace and its entities.
 - [Azure Service Bus Data Receiver](../../../articles/role-based-access-control/built-in-roles.md#azure-service-bus-data-receiver): Use this role to give the receive access to Service Bus namespace and its entities.
 
 If you want to create a custom role, see [Rights required for Service Bus operations](../../../articles/service-bus-messaging/service-bus-sas.md#rights-required-for-service-bus-operations).
 
+### Create a user in Azure Active Directory 
+
+If you are already have an Azure Active Directory (Azure AD) user account, skip this step. If not (for example, if you logged in using a Microsoft account like: `[email protected]`), create a user in Azure AD.
+
+1. Sign-in to [Azure portal](https://portal.azure.com) in a new tab or new web browser window.
+1. In the search bar at the top, type **Azure Active Directory**, and select **Azure Active Directory** from the results. 
+1. On the Azure Active Directory page, select **Users** under **Manage** on the left navigational menu.
+1. On the **Users** page, select **+ New user** on the command bar, and then select **Create new user**.
+1. On the **New user** page, follow these steps:
+    1. For **User name**, enter a name for the user. For example: **john.doe**.
+    1. For **Name**, specify the full name. For example: **John Doe**. 
+    1. Select **Create** to create the user in Azure AD. 
+
+### Add Azure AD user to Azure Service Bus Owner role
+
+Add your Azure AD user name or the one you created in the previous step to the **Azure Service Bus Data Owner** role at the Service Bus namespace level. It will allow an app running in the context of this user account to send messages to a queue or a topic, and receive messages from a queue or a topic's subscription. 
+
 > [!IMPORTANT]
 > In most cases, it will take a minute or two for the role assignment to propagate in Azure. In rare cases, it may take up to eight minutes. If you receive authentication errors when you first run your code, wait a few moments and try again.
 
-1. In the Azure portal, locate your service bus namespace using the main search bar or left navigation.
-
+1. If you don't have the Service Bus Namespace page open in the Azure portal, locate your Service Bus namespace using the main search bar or left navigation.
 2. On the overview page, select **Access control (IAM)** from the left-hand menu.	
-
 3. On the **Access control (IAM)** page, select the **Role assignments** tab.
-
 4. Select **+ Add** from the top menu and then **Add role assignment** from the resulting drop-down menu.
 
     :::image type="content" source="media/service-bus-assign-roles/add-role.png" alt-text="A screenshot showing how to assign a role.":::    
-
 5. Use the search box to filter the results to the desired role. For this example, search for `Azure Service Bus Data Owner` and select the matching result. Then choose **Next**.
+1. Under **Assign access to**, select **User, group, or service principal**, and then choose **+ Select members**.
 
-6. Under **Assign access to**, select **User, group, or service principal**, and then choose **+ Select members**.
-
-7. In the dialog, search for your Azure AD username (usually your *user@domain* email address) and then choose **Select** at the bottom of the dialog. 
-
-8. Select **Review + assign** to go to the final page, and then **Review + assign** again to complete the process.
+    
+1. In the dialog, search for your Azure AD username (usually your *user@domain* email address) and then choose **Select** at the bottom of the dialog. 
+1. Select **Review + assign** to go to the final page, and then **Review + assign** again to complete the process.