From 6a1743f6296453b77264de0bc8a619ca90a1d60f Mon Sep 17 00:00:00 2001
From: "David R. Williamson" <drwill@microsoft.com>
Date: Wed, 3 Jun 2020 10:57:02 -0700
Subject: [PATCH] webdocs(adt): test seealso, and adding links for more
 resources

---
 .../src/DigitalTwinsClient.cs                 | 20 +++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/DigitalTwinsClient.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/DigitalTwinsClient.cs
index 128a67bf9f5b..ea4e021ab176 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/DigitalTwinsClient.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/DigitalTwinsClient.cs
@@ -32,6 +32,12 @@ public class DigitalTwinsClient
         /// </summary>
         /// <param name='endpoint'>The Azure digital twins service instance URI to connect to.</param>
         /// <param name="credential">The <see cref="TokenCredential"/> implementation which will be used to request for the authentication token.</param>
+        /// <seealso cref="DigitalTwinsClient(Uri, TokenCredential)">
+        /// This other constructor provides an opportunity to override default behavior, including specifying API version,
+        /// overriding <see href="https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/core/Azure.Core/samples/Pipeline.md">transport</see>,
+        /// enabling <see href="https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/core/Azure.Core/samples/Diagnostics.md">diagnostics</see>,
+        /// and controlling <see href="https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/core/Azure.Core/samples/Configuration.md">retry strategy</see>.
+        /// </seealso>
         /// <example>
         /// <code snippet="Snippet:DigitalTwinsSampleCreateServiceClientWithClientSecret">
         /// // By using the ClientSecretCredential, a specified application Id can login using a
@@ -53,11 +59,17 @@ public DigitalTwinsClient(Uri endpoint, TokenCredential credential)
         }
 
         /// <summary>
-        /// Creates a new instance of the <see cref="DigitalTwinsClient"/> class.
+        /// Creates a new instance of the <see cref="DigitalTwinsClient"/> class, with options.
         /// </summary>
         /// <param name='endpoint'>The Azure digital twins service instance URI to connect to.</param>
         /// <param name="credential">The <see cref="TokenCredential"/> implementation which will be used to request for the authentication token.</param>
-        /// <param name="options"> Options that allow configuration of requests sent to the digital twins service.</param>
+        /// <param name="options">Options that allow configuration of requests sent to the digital twins service.</param>
+        /// <remarks>
+        /// The options parameter provides an opportunity to override default behavior, including specifying API version,
+        /// overriding <see href="https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/core/Azure.Core/samples/Pipeline.md">transport</see>,
+        /// enabling <see href="https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/core/Azure.Core/samples/Diagnostics.md">diagnostics</see>,
+        /// and controlling <see href="https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/core/Azure.Core/samples/Configuration.md">retry strategy</see>.
+        /// </remarks>
         /// <example>
         /// <code snippet="Snippet:DigitalTwinsSampleCreateServiceClientInteractiveLogin">
         /// // This illustrates how to specify client options, in this case, by providing an
@@ -96,11 +108,11 @@ public DigitalTwinsClient(Uri endpoint, TokenCredential credential, DigitalTwins
         }
 
         /// <summary>
-        /// Creates a new instance of the <see cref="DigitalTwinsClient"/> class.
+        /// Creates a new instance of the <see cref="DigitalTwinsClient"/> class, provided for unit testing purposes only.
         /// </summary>
         protected DigitalTwinsClient()
         {
-            // This constructor only exists for mocking purposes in unit tests. It should not be used otherwise
+            // This constructor only exists for mocking purposes in unit tests. It should not be used otherwise.
         }
 
         /// <summary>