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
///
/// The Azure digital twins service instance URI to connect to.
/// The implementation which will be used to request for the authentication token.
+ ///
+ /// This other constructor provides an opportunity to override default behavior, including specifying API version,
+ /// overriding transport,
+ /// enabling diagnostics,
+ /// and controlling retry strategy.
+ ///
///
///
/// // By using the ClientSecretCredential, a specified application Id can login using a
@@ -53,11 +59,17 @@ public DigitalTwinsClient(Uri endpoint, TokenCredential credential)
}
///
- /// Creates a new instance of the class.
+ /// Creates a new instance of the class, with options.
///
/// The Azure digital twins service instance URI to connect to.
/// The implementation which will be used to request for the authentication token.
- /// Options that allow configuration of requests sent to the digital twins service.
+ /// Options that allow configuration of requests sent to the digital twins service.
+ ///
+ /// The options parameter provides an opportunity to override default behavior, including specifying API version,
+ /// overriding transport,
+ /// enabling diagnostics,
+ /// and controlling retry strategy.
+ ///
///
///
/// // This illustrates how to specify client options, in this case, by providing an
@@ -96,11 +108,11 @@ public DigitalTwinsClient(Uri endpoint, TokenCredential credential, DigitalTwins
}
///
- /// Creates a new instance of the class.
+ /// Creates a new instance of the class, provided for unit testing purposes only.
///
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.
}
///