diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/DigitalTwinsClient.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/DigitalTwinsClient.cs
index 43c56f41fb311..9fd92e443cfa7 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/DigitalTwinsClient.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/DigitalTwinsClient.cs
@@ -38,6 +38,9 @@ public class DigitalTwinsClient
/// enabling diagnostics,
/// and controlling retry strategy.
///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
///
/// // By using the ClientSecretCredential, a specified application Id can login using a
@@ -65,10 +68,15 @@ public DigitalTwinsClient(Uri endpoint, TokenCredential credential)
/// The implementation which will be used to request for the authentication token.
/// 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.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
///
///
@@ -119,9 +127,14 @@ protected DigitalTwinsClient()
/// Gets a digital twin asynchronously. After the task completes, the result will be set to .
///
///
+ ///
/// The returned application/json string can always be deserialized into an instance of .
/// It may also be deserialized into custom digital twin types that extend the with additional
/// strongly typed properties provided that you know the definition of the retrieved digital twin prior to deserialization.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The Id of the digital twin.
/// The cancellation token.
@@ -158,9 +171,14 @@ public virtual Task> GetDigitalTwinAsync(string digitalTwinId,
/// Gets a digital twin synchronously. After the task completes, the result will be set to .
///
///
+ ///
/// The returned application/json string can always be deserialized into an instance of .
/// It may also be deserialized into custom digital twin types that extend the with additional
/// strongly typed properties provided that you know the definition of the retrieved digital twin prior to deserialization.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The Id of the digital twin.
/// The cancellation token.
@@ -183,6 +201,9 @@ public virtual Response GetDigitalTwin(string digitalTwinId, Cancellatio
/// The application/json digital twin to create.
/// The cancellation token.
/// The created application/json digital twin and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -222,6 +243,9 @@ public virtual Task> CreateDigitalTwinAsync(string digitalTwinI
/// The application/json digital twin to create.
/// The cancellation token.
/// The created application/json digital twin and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
///
/// The exception is thrown when or is null.
@@ -240,6 +264,9 @@ public virtual Response CreateDigitalTwin(string digitalTwinId, string d
/// The optional settings for this request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -266,15 +293,20 @@ public virtual Task DeleteDigitalTwinAsync(string digitalTwinId, Reque
/// The optional settings for this request.
/// The cancellation token.
/// The http response.
+ ///
+ ///
+ /// To delete a digital twin, any relationships referencing it must be deleted first.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
///
/// The exception is thrown when is null.
///
- ///
- /// To delete a digital twin, any relationships referencing it must be deleted first.
- ///
public virtual Response DeleteDigitalTwin(string digitalTwinId, RequestOptions requestOptions = default, CancellationToken cancellationToken = default)
{
return _dtRestClient.Delete(digitalTwinId, requestOptions?.IfMatchEtag, cancellationToken);
@@ -288,6 +320,9 @@ public virtual Response DeleteDigitalTwin(string digitalTwinId, RequestOptions r
/// The optional settings for this request.
/// The cancellationToken.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -307,6 +342,9 @@ public virtual Task> UpdateDigitalTwinAsync(string digitalTwinI
/// The optional settings for this request.
/// The cancellationToken.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -328,6 +366,9 @@ public virtual Response UpdateDigitalTwin(string digitalTwinId, string d
/// The component being retrieved.
/// The cancellation token.
/// Json string representation of the component corresponding to the provided componentPath and the HTTP response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -353,6 +394,9 @@ public virtual Task> GetComponentAsync(string digitalTwinId, st
/// The component being retrieved.
/// The cancellation token.
/// Json string representation of the component corresponding to the provided componentPath and the HTTP response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -376,6 +420,9 @@ public virtual Response GetComponent(string digitalTwinId, string compon
/// The optional settings for this request.
/// The cancellation token.
/// The HTTP response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -409,6 +456,9 @@ public virtual Task> UpdateComponentAsync(string digitalTwinId,
/// The optional settings for this request.
/// The cancellation token.
/// The HTTP response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
///
/// The exception is thrown when or is null.
@@ -430,6 +480,9 @@ public virtual Response UpdateComponent(string digitalTwinId, string com
/// The name of a relationship to filter to. If null, all relationships for the digital twin will be returned.
/// The cancellation token.
/// The pageable list of application/json relationships belonging to the specified digital twin and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -490,6 +543,9 @@ async Task> NextPageFunc(string nextLink, int? pageSizeHint)
/// The name of a relationship to filter to. If null, all relationships for the digital twin will be returned.
/// The cancellation token.
/// The pageable list of application/json relationships belonging to the specified digital twin and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -547,6 +603,9 @@ Page NextPageFunc(string nextLink, int? pageSizeHint)
/// The Id of the target digital twin.
/// The cancellation token.
/// The pageable list of application/json relationships directed towards the specified digital twin and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -601,6 +660,9 @@ async Task> NextPageFunc(string nextLink, int? pageSi
/// The Id of the target digital twin.
/// The cancellation token.
/// The pageable list of application/json relationships directed towards the specified digital twin and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -654,6 +716,9 @@ Page NextPageFunc(string nextLink, int? pageSizeHint)
/// The Id of the relationship to retrieve.
/// The cancellation token.
/// The application/json relationship corresponding to the provided relationshipId and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -672,6 +737,9 @@ public virtual Task> GetRelationshipAsync(string digitalTwinId,
/// The Id of the relationship to retrieve.
/// The cancellation token.
/// The application/json relationship corresponding to the provided relationshipId and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -694,6 +762,9 @@ public virtual Response GetRelationship(string digitalTwinId, string rel
/// The optional settings for this request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
///
/// The exception is thrown when or is null.
@@ -713,6 +784,9 @@ public virtual Task DeleteRelationshipAsync(string digitalTwinId, stri
/// The optional settings for this request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -735,15 +809,20 @@ public virtual Response DeleteRelationship(string digitalTwinId, string relation
/// The application/json relationship to be created.
/// The cancellation token.
/// The http response.
+ ///
+ ///
+ /// Relationships are a one-way link from a source digital twin to another, as described at creation time of the assigned model of the digital twin.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
///
/// The exception is thrown when or is null.
///
- ///
- /// Relationships are a one-way link from a source digital twin to another, as described at creation time of the assigned model of the digital twin.
- ///
///
///
/// // From loaded relationships, get the source Id and Id from each one,
@@ -781,15 +860,20 @@ public virtual Task> CreateRelationshipAsync(string digitalTwin
/// The application/json relationship to be created.
/// The cancellation token.
/// The http response.
+ ///
+ ///
+ /// Relationships are a one-way link from a source digital twin to another, as described at creation time of the assigned model of the digital twin.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
///
/// The exception is thrown when or is null.
///
- ///
- /// Relationships are a one-way link from a source digital twin to another, as described at creation time of the assigned model of the digital twin.
- ///
///
/// See the asynchronous version of this method for examples.
///
@@ -807,6 +891,9 @@ public virtual Response CreateRelationship(string digitalTwinId, string
/// The optional settings for this request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -828,6 +915,9 @@ public virtual Task UpdateRelationshipAsync(string digitalTwinId, stri
/// The optional settings for this request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -850,6 +940,9 @@ public virtual Response UpdateRelationship(string digitalTwinId, string relation
/// The options to follow when listing the models. For example, the page size hint can be specified.
/// The cancellation token.
/// A pageable set of application/json models and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -907,6 +1000,9 @@ async Task> NextPageFunc(string nextLink, int? pageSizeHint)
/// The options to follow when listing the models. For example, the page size hint can be specified.
/// The cancellation token.
/// A pageable set of application/json models and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -956,6 +1052,9 @@ Page NextPageFunc(string nextLink, int? pageSizeHint)
/// The Id of the model.
/// The cancellation token.
/// The application/json model and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -979,6 +1078,9 @@ public virtual Task> GetModelAsync(string modelId, Cancellat
/// The Id of the model.
/// The cancellation token.
/// The application/json model and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1000,17 +1102,22 @@ public virtual Response GetModel(string modelId, CancellationToken ca
/// The Id of the model to decommission.
/// The cancellation token.
/// The http response.
+ ///
+ ///
+ /// When a model is decomissioned, new digital twins will no longer be able to be defined by this model.
+ /// However, existing digital twins may continue to use this model.
+ /// Once a model is decomissioned, it may not be recommissioned.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
///
/// The exception is thrown when is null.
///
- ///
- /// When a model is decomissioned, new digital twins will no longer be able to be defined by this model.
- /// However, existing digital twins may continue to use this model.
- /// Once a model is decomissioned, it may not be recommissioned.
- ///
///
///
/// try
@@ -1035,17 +1142,22 @@ public virtual Task DecommissionModelAsync(string modelId, Cancellatio
/// The Id of the model to decommission.
/// The cancellation token.
/// The http response.
+ ///
+ ///
+ /// When a model is decomissioned, new digital twins will no longer be able to be defined by this model.
+ /// However, existing digital twins may continue to use this model.
+ /// Once a model is decomissioned, it may not be recommissioned.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
///
/// The exception is thrown when is null.
///
- ///
- /// When a model is decomissioned, new digital twins will no longer be able to be defined by this model.
- /// However, existing digital twins may continue to use this model.
- /// Once a model is decomissioned, it may not be recommissioned.
- ///
///
/// See the asynchronous version of this method for examples.
///
@@ -1064,10 +1176,15 @@ public virtual Response DecommissionModel(string modelId, CancellationToken canc
/// The exception that captures the errors from the service. Check the and properties for more details.
///
///
+ ///
/// Bulk model creation is useful when several models have references to each other.
/// It simplifies creation for the client because otherwise the models would have to be created in a very specific order.
/// The service evaluates all models to ensure all references are satisfied, and then accepts or rejects the set.
/// So using this method, model creation is transactional.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
///
///
@@ -1086,15 +1203,20 @@ public virtual Task>> CreateModelsAsync(IEnume
/// The set of models to create. Each string corresponds to exactly one model.
/// The cancellation token.
/// The created models and the http response.
- ///
- /// The exception that captures the errors from the service. Check the and properties for more details.
- ///
///
+ ///
/// Bulk model creation is useful when several models have references to each other.
/// It simplifies creation for the client because otherwise the models would have to be created in a very specific order.
/// The service evaluates all models to ensure all references are satisfied, and then accepts or rejects the set.
/// So using this method, model creation is transactional.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
+ ///
+ /// The exception that captures the errors from the service. Check the and properties for more details.
+ ///
///
/// See the asynchronous version of this method for examples.
///
@@ -1109,20 +1231,25 @@ public virtual Response> CreateModels(IEnumerable The id for the model. The id is globally unique and case sensitive.
/// The cancellation token to use.
/// The http response.
- ///
- /// The exception that captures the errors from the service. Check the and properties for more details.
- ///
- ///
- /// The exception is thrown when is null.
- ///
///
+ ///
/// A model can only be deleted if no other models reference it.
/// Status codes:
/// 204 (No Content): Success.
/// 400 (Bad Request): The request is invalid.
/// 404 (Not Found): There is no model with the provided id.
/// 409 (Conflict): There are dependencies on the model that prevent it from being deleted.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
+ ///
+ /// The exception that captures the errors from the service. Check the and properties for more details.
+ ///
+ ///
+ /// The exception is thrown when is null.
+ ///
///
///
/// try
@@ -1148,20 +1275,25 @@ public virtual Task DeleteModelAsync(string modelId, CancellationToken
/// The id for the model. The id is globally unique and case sensitive.
/// The cancellation token to use.
/// The http response.
- ///
- /// The exception that captures the errors from the service. Check the and properties for more details.
- ///
- ///
- /// The exception is thrown when is null.
- ///
///
+ ///
/// A model can only be deleted if no other models reference it.
/// Status codes:
/// 204 (No Content): Success.
/// 400 (Bad Request): The request is invalid.
/// 404 (Not Found): There is no model with the provided id.
/// 409 (Conflict): There are dependencies on the model that prevent it from being deleted.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
+ ///
+ /// The exception that captures the errors from the service. Check the and properties for more details.
+ ///
+ ///
+ /// The exception is thrown when is null.
+ ///
///
/// See the asynchronous version of this method for examples.
///
@@ -1176,6 +1308,9 @@ public virtual Response DeleteModel(string modelId, CancellationToken cancellati
/// The query string, in SQL-like syntax.
/// The cancellation token.
/// The pageable list of query results.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1248,6 +1383,9 @@ async Task> NextPageFunc(string nextLink, int? pageSizeHint)
/// The query string, in SQL-like syntax.
/// The cancellation token.
/// The pageable list of query results.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1310,6 +1448,9 @@ Page NextPageFunc(string nextLink, int? pageSizeHint)
/// The options to use when listing the event routes. One can set the maximum number of items to retrieve per request, however the service may return less than requested.
/// The cancellation token.
/// A pageable set of application/json event routes and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1365,6 +1506,9 @@ async Task> NextPageFunc(string nextLink, int? pageSizeHint)
/// The options to use when listing the event routes. One can set the maximum number of items to retrieve per request, however the service may return less than requested.
/// The cancellation token.
/// A pageable set of application/json event routes and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1414,6 +1558,9 @@ Page NextPageFunc(string nextLink, int? pageSizeHint)
/// The Id of the event route.
/// The cancellation token.
/// The application/json event routes and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1431,6 +1578,9 @@ public virtual Task> GetEventRouteAsync(string eventRouteId
/// The Id of the event route.
/// The cancellation token.
/// The application/json event routes and the http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1452,6 +1602,9 @@ public virtual Response GetEventRoute(string eventRouteId, Cancellat
/// The event route data containing the endpoint and optional filter.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1481,6 +1634,9 @@ public virtual Task CreateEventRouteAsync(string eventRouteId, EventRo
/// The event route data containing the endpoint and optional filter.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1501,6 +1657,9 @@ public virtual Response CreateEventRoute(string eventRouteId, EventRoute eventRo
/// The Id of the event route to delete.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1523,6 +1682,9 @@ public virtual Task DeleteEventRouteAsync(string eventRouteId, Cancell
/// The Id of the event route to delete.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1547,6 +1709,9 @@ public virtual Response DeleteEventRoute(string eventRouteId, CancellationToken
/// The additional information to be used when processing a telemetry request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1579,6 +1744,9 @@ public virtual Task PublishTelemetryAsync(string digitalTwinId, string
/// The additional information to be used when processing a telemetry request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1607,6 +1775,9 @@ public virtual Response PublishTelemetry(string digitalTwinId, string payload, T
/// The additional information to be used when processing a telemetry request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
@@ -1647,6 +1818,9 @@ public virtual Task PublishComponentTelemetryAsync(string digitalTwinI
/// The additional information to be used when processing a telemetry request.
/// The cancellation token.
/// The http response.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// The exception that captures the errors from the service. Check the and properties for more details.
///
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Models/TelemetryOptions.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Models/TelemetryOptions.cs
index 9f5fed471bbe1..f84cc00ebe7bc 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Models/TelemetryOptions.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Models/TelemetryOptions.cs
@@ -8,6 +8,9 @@ namespace Azure.DigitalTwins.Core.Models
///
/// The additional information to be used when processing a telemetry request.
///
+ ///
+ /// For more samples, see our repo samples.
+ ///
public class TelemetryOptions
{
///
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Queries/QueryChargeHelper.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Queries/QueryChargeHelper.cs
index d3bcdc6156556..3a4c1f068a822 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Queries/QueryChargeHelper.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Queries/QueryChargeHelper.cs
@@ -21,6 +21,9 @@ public static class QueryChargeHelper
/// The page that contains the query-charge header.
/// The query charge extracted from the header.
/// True if the header contains a query-charge field, otherwise false.
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// // This code snippet demonstrates how you could extract the query charges incurred when calling
/// // the query API. It iterates over the response pages first to access to the query-charge header,
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/BasicDigitalTwin.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/BasicDigitalTwin.cs
index 9c01cf34ec227..65fdc65ab1220 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/BasicDigitalTwin.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/BasicDigitalTwin.cs
@@ -8,6 +8,9 @@ namespace Azure.DigitalTwins.Core.Serialization
///
/// An optional, helper class for deserializing a digital twin.
///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
/// Here's an example of how to use the BasicDigitalTwin helper class to serialize and create a digital twin.
///
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/BasicRelationship.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/BasicRelationship.cs
index 7bfa3226396fe..bd30907351d60 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/BasicRelationship.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/BasicRelationship.cs
@@ -10,6 +10,9 @@ namespace Azure.DigitalTwins.Core.Serialization
/// Although relationships have a user-defined schema, these properties should exist on every instance. This is
/// useful to use as a base class to ensure your custom relationships have the necessary properties.
///
+ ///
+ /// For more samples, see our repo samples.
+ ///
public class BasicRelationship
{
///
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/DigitalTwinMetadata.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/DigitalTwinMetadata.cs
index 9ad50b073ddb0..9e24f8068c84f 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/DigitalTwinMetadata.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/DigitalTwinMetadata.cs
@@ -10,6 +10,9 @@ namespace Azure.DigitalTwins.Core.Serialization
/// An optional, helper class for deserializing a digital twin.
/// The $metadata class on a and .
///
+ ///
+ /// For more samples, see our repo samples.
+ ///
public class DigitalTwinMetadata
{
///
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/ModelProperties.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/ModelProperties.cs
index 0b243fab7661d..9e8bf4457b462 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/ModelProperties.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/ModelProperties.cs
@@ -9,6 +9,9 @@ namespace Azure.DigitalTwins.Core.Serialization
///
/// Properties on a digital twin that adhere to a specific model.
///
+ ///
+ /// For more samples, see our repo samples.
+ ///
public class ModelProperties
{
///
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/UpdateOperationsUtility.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/UpdateOperationsUtility.cs
index 48efd0c340643..7a268d75862e6 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/UpdateOperationsUtility.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/UpdateOperationsUtility.cs
@@ -9,6 +9,9 @@ namespace Azure.DigitalTwins.Core.Serialization
///
/// A utility to create the application/json-patch+json operations payload required for update operations.
///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
///
/// // Update Component1 by replacing the property ComponentProp1 value
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/WritableProperty.cs b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/WritableProperty.cs
index 541154e0e094c..826afb58cd6a2 100644
--- a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/WritableProperty.cs
+++ b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/Serialization/WritableProperty.cs
@@ -10,7 +10,12 @@ namespace Azure.DigitalTwins.Core.Serialization
/// The ModelProperties dictionary on .
///
///
+ ///
/// A writable property is one that the service may request a change for from the device.
+ ///
+ ///
+ /// For more samples, see our repo samples.
+ ///
///
public class WritableProperty
{