Merge pull request MicrosoftDocs#77095 from ramya-rao-a/patch-3

v-dansch · web-flow · commit 0bcfed202512 · 2019-05-17T14:10:53.000-07:00
Include API reference links in Quick Start for Service Bus Queues
diff --git a/articles/service-bus-messaging/service-bus-nodejs-how-to-use-queues-new-package.md b/articles/service-bus-messaging/service-bus-nodejs-how-to-use-queues-new-package.md
@@ -22,7 +22,7 @@ ms.author: aschhab
 > - [(Node.js | azure-sb)](service-bus-nodejs-how-to-use-queues.md)
 > - [(Node.js | @azure/service-bus)](service-bus-nodejs-how-to-use-queues-new-package.md)
 
-In this tutorial, you learn how to create Node.js applications to send messages to and receive messages from a Service Bus queue using the new [@azure/service-bus](https://www.npmjs.com/package/@azure/service-bus) package. This package uses the faster [AMQP 1.0 protocol](service-bus-amqp-overview.md) whereas the older [azure-sb](https://www.npmjs.com/package/azure-sb) package used [Service Bus REST run-time APIs](/rest/api/servicebus/service-bus-runtime-rest). The samples are written in JavaScript.
+In this tutorial, you learn how to write a Nodejs program to send messages to and receive messages from a Service Bus queue using the new [@azure/service-bus](https://www.npmjs.com/package/@azure/service-bus) package. This package uses the faster [AMQP 1.0 protocol](service-bus-amqp-overview.md) whereas the older [azure-sb](https://www.npmjs.com/package/azure-sb) package used [Service Bus REST run-time APIs](/rest/api/servicebus/service-bus-runtime-rest). The samples are written in JavaScript.
 
 ## Prerequisites
 - An Azure subscription. To complete this tutorial, you need an Azure account. You can activate your [MSDN subscriber benefits](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/?WT.mc_id=A85619ABF) or sign up for a [free account](https://azure.microsoft.com/free/?WT.mc_id=A85619ABF).
@@ -40,10 +40,10 @@ npm install @azure/service-bus
 ```
 
 ## Send messages to a queue
-Interacting with a Service Bus queue starts with instantiating the `ServiceBusClient` class and using it to instantiate the `QueueClient` class. Once you have the queue client, you can create a sender and use  either `send` or `sendBatch` method on it to send messages.
+Interacting with a Service Bus queue starts with instantiating the [ServiceBusClient](https://docs.microsoft.com/javascript/api/@azure/service-bus/servicebusclient) class and using it to instantiate the [QueueClient](https://docs.microsoft.com/javascript/api/%40azure/service-bus/queueclient) class. Once you have the queue client, you can create a sender and use  either [send](https://docs.microsoft.com/javascript/api/%40azure/service-bus/sender#send-sendablemessageinfo-) or [sendBatch](https://docs.microsoft.com/javascript/api/@azure/service-bus/sender#sendbatch-sendablemessageinfo---) method on it to send messages.
 
-1. Open your favorite editor, such as Visual Studio Code
-2. Create a file called `send.js` and paste the below code into it
+1. Open your favorite editor, such as [Visual Studio Code](https://code.visualstudio.com/)
+2. Create a file called `send.js` and paste the below code into it. This code will send 10 messages to your queue.
 
     ```javascript
     const { ServiceBusClient } = require("@azure/service-bus"); 
@@ -81,17 +81,19 @@ Interacting with a Service Bus queue starts with instantiating the `ServiceBusCl
     });
     ```
 3. Enter the connection string and name of your queue in the above code.
-4. Then run the command `node send.js` in a command prompt to execute this file. This command will send 10 messages to your queue.
+4. Then run the command `node send.js` in a command prompt to execute this file.
 
-    The messages you send can have some standard properties like `label` and `messageId`. If you want to set any custom properties, use the `userProperties`, which is a json object that can hold key-value pairs of your custom data.
+Congratulations! You just sent messages to a Service Bus queue.
 
-    Service Bus queues support a maximum message size of 256 KB in the [Standard tier](service-bus-premium-messaging.md) and 1 MB in the [Premium tier](service-bus-premium-messaging.md). There's no limit on the number of messages held in a queue but there's a cap on the total size of the messages held by a queue. This queue size is defined at creation time, with an upper limit of 5 GB. For more information about quotas, see [Service Bus quotas](service-bus-quotas.md).
+Messages have some standard properties like `label` and `messageId` that you can set when sending. If you want to set any custom properties, use the `userProperties`, which is a json object that can hold key-value pairs of your custom data.
+
+Service Bus queues support a maximum message size of 256 KB in the [Standard tier](service-bus-premium-messaging.md) and 1 MB in the [Premium tier](service-bus-premium-messaging.md). There's no limit on the number of messages held in a queue but there's a cap on the total size of the messages held by a queue. This queue size is defined at creation time, with an upper limit of 5 GB. For more information about quotas, see [Service Bus quotas](service-bus-quotas.md).
 
 ## Receive messages from a queue
-Interacting with a Service Bus queue starts with instantiating the `ServiceBusClient` class and using it to instantiate the `QueueClient` class. Once you have the queue client, you can create a receiver and use  either `receiveMessages` or `registerMessageHandler` method on it to receive messages.
+Interacting with a Service Bus queue starts with instantiating the [ServiceBusClient](https://docs.microsoft.com/javascript/api/@azure/service-bus/servicebusclient) class and using it to instantiate the [QueueClient](https://docs.microsoft.com/javascript/api/%40azure/service-bus/queueclient) class. Once you have the queue client, you can create a receiver and use  either [receiveMessages](https://docs.microsoft.com/javascript/api/%40azure/service-bus/receiver#receivemessages-number--undefined---number-) or [registerMessageHandler](https://docs.microsoft.com/javascript/api/%40azure/service-bus/receiver#registermessagehandler-onmessage--onerror--messagehandleroptions-) method on it to receive messages.
 
-1. Open your favorite editor, such as Visual Studio Code
-2. Create a file called `recieve.js` and paste the below code into it
+1. Open your favorite editor, such as [Visual Studio Code](https://code.visualstudio.com/)
+2. Create a file called `recieve.js` and paste the below code into it. This code will attempt to receive 10 messages from your queue. The actual count you receive depends on the number of messages in the queue and network latency.
 
     ```javascript
     const { ServiceBusClient, ReceiveMode } = require("@azure/service-bus"); 
@@ -120,9 +122,11 @@ Interacting with a Service Bus queue starts with instantiating the `ServiceBusCl
     });
     ```
 3. Enter the connection string and name of your queue in the above code.
-4. Then run the command `node receiveMessages.js` in a command prompt to execute this file. This command will try to receive a maximum of 10 messages from your queue. The actual count you receive may depend on the number of messages in the queue and network latency.
+4. Then run the command `node receiveMessages.js` in a command prompt to execute this file.
+
+Congratulations! You just received messages from a Service Bus queue.
 
-    The `createReceiver` method takes in a `ReceiveMode` which is an enum with values [ReceiveAndDelete](message-transfers-locks-settlement.md#settling-receive-operations) and [PeekLock](message-transfers-locks-settlement.md#settling-receive-operations). Remember to [settle your messages](message-transfers-locks-settlement.md#settling-receive-operations) if you use the `PeekLock` mode by using any of `complete()`, `abandon()`, `defer()`, or `deadletter()` methods on the message.
+The [createReceiver](https://docs.microsoft.com/javascript/api/%40azure/service-bus/queueclient#createreceiver-receivemode-) method takes in a `ReceiveMode` which is an enum with values [ReceiveAndDelete](message-transfers-locks-settlement.md#settling-receive-operations) and [PeekLock](message-transfers-locks-settlement.md#settling-receive-operations). Remember to [settle your messages](message-transfers-locks-settlement.md#settling-receive-operations) if you use the `PeekLock` mode by using any of `complete()`, `abandon()`, `defer()`, or `deadletter()` methods on the message.
 
 ## Next steps
 To learn more, see the following resources.
