modify sample link and address grammar issues

Author: yzhong94

articles/iot-dps/how-to-manage-enrollments-sdks.md

@@ -18,6 +18,7 @@ ms.custom: mvc
 # How to manage device enrollments with Azure Device Provisioning Service SDKs
 A *device enrollment* creates a record of a single device or a group of devices that may at some point register with the Device Provisioning Service. The enrollment record contains the initial desired configuration for the device(s) as part of that enrollment, including the desired IoT hub. This article shows you how to manage device enrollments for your provisioning service programmatically using the Azure IoT Provisioning Service SDKs.  The SDKs are available on GitHub in the same repository as Azure IoT SDKs.
 
+## Samples
 This article reviews the high level concepts for managing device enrollments for your provisioning service programmatically using the Azure IoT Provisioning Service SDKs.  Exact API calls may be different due to language differences.  Please review the samples we provide on GitHub for details:
 * [Java Provisioning Service Client samples](https://github.com/Azure/azure-iot-sdk-java/tree/master/provisioning/provisioning-samples)
 * [Node.js Provisioning Service Client samples](https://github.com/Azure/azure-iot-sdk-node/tree/master/provisioning/service/samples)
@@ -56,7 +57,7 @@ There are two ways you can enroll your devices with the provisioning service:
 
 After you have successfully created an enrollment, the Device Provisioning Service would return an enrollment result.
 
-This workflow is demonstrated in our samples in detail.
+This workflow is demonstrated in the [samples](#samples).
 
 ## Update an enrollment entry
 
@@ -72,14 +73,14 @@ You can update an enrollment entry following this workflow:
     2. Modify the parameter of the latest enrollment as necessary.
     3. Using the latest enrollment, call Service SDK API ```createOrUpdateEnrollmentGroup``` to update your enrollment entry.
 
-This workflow is demonstrated in our samples in detail.
+This workflow is demonstrated in the [samples](#samples).
 
 ## Remove an enrollment entry
 
 * **Individual enrollment** can be deleted by calling Service SDK API ```deleteIndividualEnrollment``` using ```registrationId```.
 * **Group enrollment** can be deleted by calling Service SDK API ```deleteEnrollmentGroup``` using ```enrollmentGroupId```.
 
-This workflow is demonstrated in our samples in detail.
+This workflow is demonstrated in the [samples](#samples).
 
 ## Bulk operation on individual enrollments
 
@@ -90,4 +91,4 @@ You can perform bulk operation to create, update, or remove multiple individual
 
 After you have successfully performed an operation, the Device Provisioning Service would return a bulk operation result.
 
-This workflow is demonstrated in our samples in detail.
+This workflow is demonstrated in the [samples](#samples).

articles/iot-dps/how-to-manage-enrollments.md

@@ -27,9 +27,9 @@ There are two ways you can enroll your devices with the provisioning service:
 
 * An **Enrollment group** is an entry for a group of devices that share a common attestation mechanism of X.509 certificates, signed by the same signing certificate, which can be the [root certificate](https://docs.microsoft.com/en-us/azure/iot-dps/concepts-security#root-certificate) or the [intermediate certificate](https://docs.microsoft.com/en-us/azure/iot-dps/concepts-security#intermediate-certificate), used to produce device certificate on physical device. We recommend using an enrollment group for a large number of devices which share a desired initial configuration, or for devices all going to the same tenant. Note that you can only enroll devices that use the X.509 attestation mechanism as *enrollment groups*. 
 
-    You can create an enrollment group in the portal for a group of devices using the following steps.
+    You can create an enrollment group in the portal for a group of devices using the following steps:
 
-    1. Log in to the Azure portal and click **All resources** from the left hand menu.
+    1. Log in to the Azure portal and click **All resources** from the left-hand menu.
     2. Click the Device Provisioning service you want to enroll your device to from the list of resources.
     3. In your provisioning service, click **Manage enrollments**, then select **Enrollment Groups** tab.
     4. Click the **Add** button at the top, and enter the information required for the enrollment list entry. Upload the root certificate for the group of devices. 
@@ -40,9 +40,9 @@ There are two ways you can enroll your devices with the provisioning service:
 
 * An **Individual enrollment** is an entry for a single device that may register. Individual enrollments may use either x509 certificates or SAS tokens (in a real or virtual TPM) as attestation mechanisms. We recommend using individual enrollments for devices which require unique initial configurations, or for devices which can only use SAS tokens via TPM or virtual TPM as the attestation mechanism. Individual enrollments may have the desired IoT hub device ID specified.
 
-    You can create an individual enrollment in the portal using the following steps. 
+    You can create an individual enrollment in the portal using the following steps:
 
-    1. Log in to the Azure portal and click **All resources** from the left hand menu.
+    1. Log in to the Azure portal and click **All resources** from the left-hand menu.
     2. Click the Device Provisioning service you want to enroll your device to from the list of resources.
     3. In your provisioning service, click **Manage enrollments**, then select **Individual Enrollments** tab.
     4. Click the **Add** button at the top. 
@@ -53,7 +53,7 @@ There are two ways you can enroll your devices with the provisioning service:
 
 
 ## Update an enrollment entry
-You can update an existing enrollment entry in the portal using the following steps.
+You can update an existing enrollment entry in the portal using the following steps:
 
 1. Open your Device Provisioning service in the Azure portal and click **Manage Enrollments**. 
 2. Navigate to the enrollment entry you want to modify. Click the entry, which opens a summary information about your device enrollment. 
@@ -64,7 +64,7 @@ You can update an existing enrollment entry in the portal using the following st
 
 
 ## Remove a device enrollment
-In cases where your device(s) do not need to be provisioned to any IoT hub, you can remove the related enrollment entry in the portal using the following steps.
+In cases where your device(s) do not need to be provisioned to any IoT hub, you can remove the related enrollment entry in the portal using the following steps:
 
 1. Open your Device Provisioning service in the Azure portal and click **Manage Enrollments**. 
 2. Navigate to and select the enrollment entry you want to remove.