Initial doc comment support (#388)

samples/AppConfiguration/AppConfiguration/Generated/Models/Enum0.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
     public readonly partial struct Enum0 : IEquatable<Enum0>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="Enum0"/> values are the same. </summary>
         public Enum0(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -24,24 +26,39 @@ namespace AppConfiguration.Models.V10
         private const string LockedValue = "locked";
         private const string EtagValue = "etag";
 
+        /// <summary> key. </summary>
         public static Enum0 Key { get; } = new Enum0(KeyValue);
+        /// <summary> label. </summary>
         public static Enum0 Label { get; } = new Enum0(LabelValue);
+        /// <summary> content_type. </summary>
         public static Enum0 ContentType { get; } = new Enum0(ContentTypeValue);
+        /// <summary> value. </summary>
         public static Enum0 Value { get; } = new Enum0(ValueValue);
+        /// <summary> last_modified. </summary>
         public static Enum0 LastModified { get; } = new Enum0(LastModifiedValue);
+        /// <summary> tags. </summary>
         public static Enum0 Tags { get; } = new Enum0(TagsValue);
+        /// <summary> locked. </summary>
         public static Enum0 Locked { get; } = new Enum0(LockedValue);
+        /// <summary> etag. </summary>
         public static Enum0 Etag { get; } = new Enum0(EtagValue);
+        /// <summary> Determines if two <see cref="Enum0"/> values are the same. </summary>
         public static bool operator ==(Enum0 left, Enum0 right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="Enum0"/> values are not the same. </summary>
         public static bool operator !=(Enum0 left, Enum0 right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="Enum0"/>. </summary>
         public static implicit operator Enum0(string value) => new Enum0(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is Enum0 other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(Enum0 other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/Error.cs

@@ -3,12 +3,18 @@
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> Azure App Configuration error object. </summary>
     public partial class Error
     {
+        /// <summary> The type of the error. </summary>
         public string? Type { get; set; }
+        /// <summary> A brief summary of the error. </summary>
         public string? Title { get; set; }
+        /// <summary> The name of the parameter that resulted in the error. </summary>
         public string? Name { get; set; }
+        /// <summary> A detailed description of the error. </summary>
         public string? Detail { get; set; }
+        /// <summary> The HTTP status code that the error maps to. </summary>
         public int? Status { get; set; }
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/Get6ItemsItem.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
     public readonly partial struct Get6ItemsItem : IEquatable<Get6ItemsItem>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="Get6ItemsItem"/> values are the same. </summary>
         public Get6ItemsItem(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -24,24 +26,39 @@ namespace AppConfiguration.Models.V10
         private const string LockedValue = "locked";
         private const string EtagValue = "etag";
 
+        /// <summary> key. </summary>
         public static Get6ItemsItem Key { get; } = new Get6ItemsItem(KeyValue);
+        /// <summary> label. </summary>
         public static Get6ItemsItem Label { get; } = new Get6ItemsItem(LabelValue);
+        /// <summary> content_type. </summary>
         public static Get6ItemsItem ContentType { get; } = new Get6ItemsItem(ContentTypeValue);
+        /// <summary> value. </summary>
         public static Get6ItemsItem Value { get; } = new Get6ItemsItem(ValueValue);
+        /// <summary> last_modified. </summary>
         public static Get6ItemsItem LastModified { get; } = new Get6ItemsItem(LastModifiedValue);
+        /// <summary> tags. </summary>
         public static Get6ItemsItem Tags { get; } = new Get6ItemsItem(TagsValue);
+        /// <summary> locked. </summary>
         public static Get6ItemsItem Locked { get; } = new Get6ItemsItem(LockedValue);
+        /// <summary> etag. </summary>
         public static Get6ItemsItem Etag { get; } = new Get6ItemsItem(EtagValue);
+        /// <summary> Determines if two <see cref="Get6ItemsItem"/> values are the same. </summary>
         public static bool operator ==(Get6ItemsItem left, Get6ItemsItem right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="Get6ItemsItem"/> values are not the same. </summary>
         public static bool operator !=(Get6ItemsItem left, Get6ItemsItem right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="Get6ItemsItem"/>. </summary>
         public static implicit operator Get6ItemsItem(string value) => new Get6ItemsItem(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is Get6ItemsItem other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(Get6ItemsItem other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/Get7ItemsItem.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
     public readonly partial struct Get7ItemsItem : IEquatable<Get7ItemsItem>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="Get7ItemsItem"/> values are the same. </summary>
         public Get7ItemsItem(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -24,24 +26,39 @@ namespace AppConfiguration.Models.V10
         private const string LockedValue = "locked";
         private const string EtagValue = "etag";
 
+        /// <summary> key. </summary>
         public static Get7ItemsItem Key { get; } = new Get7ItemsItem(KeyValue);
+        /// <summary> label. </summary>
         public static Get7ItemsItem Label { get; } = new Get7ItemsItem(LabelValue);
+        /// <summary> content_type. </summary>
         public static Get7ItemsItem ContentType { get; } = new Get7ItemsItem(ContentTypeValue);
+        /// <summary> value. </summary>
         public static Get7ItemsItem Value { get; } = new Get7ItemsItem(ValueValue);
+        /// <summary> last_modified. </summary>
         public static Get7ItemsItem LastModified { get; } = new Get7ItemsItem(LastModifiedValue);
+        /// <summary> tags. </summary>
         public static Get7ItemsItem Tags { get; } = new Get7ItemsItem(TagsValue);
+        /// <summary> locked. </summary>
         public static Get7ItemsItem Locked { get; } = new Get7ItemsItem(LockedValue);
+        /// <summary> etag. </summary>
         public static Get7ItemsItem Etag { get; } = new Get7ItemsItem(EtagValue);
+        /// <summary> Determines if two <see cref="Get7ItemsItem"/> values are the same. </summary>
         public static bool operator ==(Get7ItemsItem left, Get7ItemsItem right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="Get7ItemsItem"/> values are not the same. </summary>
         public static bool operator !=(Get7ItemsItem left, Get7ItemsItem right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="Get7ItemsItem"/>. </summary>
         public static implicit operator Get7ItemsItem(string value) => new Get7ItemsItem(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is Get7ItemsItem other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(Get7ItemsItem other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/Head6ItemsItem.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
     public readonly partial struct Head6ItemsItem : IEquatable<Head6ItemsItem>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="Head6ItemsItem"/> values are the same. </summary>
         public Head6ItemsItem(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -24,24 +26,39 @@ namespace AppConfiguration.Models.V10
         private const string LockedValue = "locked";
         private const string EtagValue = "etag";
 
+        /// <summary> key. </summary>
         public static Head6ItemsItem Key { get; } = new Head6ItemsItem(KeyValue);
+        /// <summary> label. </summary>
         public static Head6ItemsItem Label { get; } = new Head6ItemsItem(LabelValue);
+        /// <summary> content_type. </summary>
         public static Head6ItemsItem ContentType { get; } = new Head6ItemsItem(ContentTypeValue);
+        /// <summary> value. </summary>
         public static Head6ItemsItem Value { get; } = new Head6ItemsItem(ValueValue);
+        /// <summary> last_modified. </summary>
         public static Head6ItemsItem LastModified { get; } = new Head6ItemsItem(LastModifiedValue);
+        /// <summary> tags. </summary>
         public static Head6ItemsItem Tags { get; } = new Head6ItemsItem(TagsValue);
+        /// <summary> locked. </summary>
         public static Head6ItemsItem Locked { get; } = new Head6ItemsItem(LockedValue);
+        /// <summary> etag. </summary>
         public static Head6ItemsItem Etag { get; } = new Head6ItemsItem(EtagValue);
+        /// <summary> Determines if two <see cref="Head6ItemsItem"/> values are the same. </summary>
         public static bool operator ==(Head6ItemsItem left, Head6ItemsItem right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="Head6ItemsItem"/> values are not the same. </summary>
         public static bool operator !=(Head6ItemsItem left, Head6ItemsItem right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="Head6ItemsItem"/>. </summary>
         public static implicit operator Head6ItemsItem(string value) => new Head6ItemsItem(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is Head6ItemsItem other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(Head6ItemsItem other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/Head7ItemsItem.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
     public readonly partial struct Head7ItemsItem : IEquatable<Head7ItemsItem>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="Head7ItemsItem"/> values are the same. </summary>
         public Head7ItemsItem(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -24,24 +26,39 @@ namespace AppConfiguration.Models.V10
         private const string LockedValue = "locked";
         private const string EtagValue = "etag";
 
+        /// <summary> key. </summary>
         public static Head7ItemsItem Key { get; } = new Head7ItemsItem(KeyValue);
+        /// <summary> label. </summary>
         public static Head7ItemsItem Label { get; } = new Head7ItemsItem(LabelValue);
+        /// <summary> content_type. </summary>
         public static Head7ItemsItem ContentType { get; } = new Head7ItemsItem(ContentTypeValue);
+        /// <summary> value. </summary>
         public static Head7ItemsItem Value { get; } = new Head7ItemsItem(ValueValue);
+        /// <summary> last_modified. </summary>
         public static Head7ItemsItem LastModified { get; } = new Head7ItemsItem(LastModifiedValue);
+        /// <summary> tags. </summary>
         public static Head7ItemsItem Tags { get; } = new Head7ItemsItem(TagsValue);
+        /// <summary> locked. </summary>
         public static Head7ItemsItem Locked { get; } = new Head7ItemsItem(LockedValue);
+        /// <summary> etag. </summary>
         public static Head7ItemsItem Etag { get; } = new Head7ItemsItem(EtagValue);
+        /// <summary> Determines if two <see cref="Head7ItemsItem"/> values are the same. </summary>
         public static bool operator ==(Head7ItemsItem left, Head7ItemsItem right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="Head7ItemsItem"/> values are not the same. </summary>
         public static bool operator !=(Head7ItemsItem left, Head7ItemsItem right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="Head7ItemsItem"/>. </summary>
         public static implicit operator Head7ItemsItem(string value) => new Head7ItemsItem(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is Head7ItemsItem other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(Head7ItemsItem other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/Key.cs

@@ -3,8 +3,10 @@
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Key
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Name { get; internal set; }
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/KeyListResult.cs

@@ -5,9 +5,12 @@ using System.Collections.Generic;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> The result of a list request. </summary>
     public partial class KeyListResult
     {
+        /// <summary> The collection value. </summary>
         public ICollection<Key>? Items { get; set; }
+        /// <summary> The URI that can be used to request the next set of paged results. </summary>
         public string? NextLink { get; set; }
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/KeyValue.cs

@@ -6,15 +6,24 @@ using System.Collections.Generic;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class KeyValue
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Key { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Label { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? ContentType { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Value { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-DATETIME. </summary>
         public DateTimeOffset? LastModified { get; set; }
+        /// <summary> Dictionary of &lt;paths·keys·get·parameters·0·schema&gt;. </summary>
         public IDictionary<string, string>? Tags { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? Locked { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Etag { get; set; }
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/KeyValueListResult.cs

@@ -5,9 +5,12 @@ using System.Collections.Generic;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> The result of a list request. </summary>
     public partial class KeyValueListResult
     {
+        /// <summary> The collection value. </summary>
         public ICollection<KeyValue>? Items { get; set; }
+        /// <summary> The URI that can be used to request the next set of paged results. </summary>
         public string? NextLink { get; set; }
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/Label.cs

@@ -3,8 +3,10 @@
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Label
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Name { get; internal set; }
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Models/LabelListResult.cs

@@ -5,9 +5,12 @@ using System.Collections.Generic;
 
 namespace AppConfiguration.Models.V10
 {
+    /// <summary> The result of a list request. </summary>
     public partial class LabelListResult
     {
+        /// <summary> The collection value. </summary>
         public ICollection<Label>? Items { get; set; }
+        /// <summary> The URI that can be used to request the next set of paged results. </summary>
         public string? NextLink { get; set; }
     }
 }

samples/AppConfiguration/AppConfiguration/Generated/Operations/AllOperations.cs

@@ -19,6 +19,7 @@ namespace AppConfiguration
         private string ApiVersion;
         private ClientDiagnostics clientDiagnostics;
         private HttpPipeline pipeline;
+        /// <summary> Initializes a new instance of AllOperations. </summary>
         public AllOperations(ClientDiagnostics clientDiagnostics, HttpPipeline pipeline, string? syncToken, string host = "", string ApiVersion = "1.0")
         {
             if (host == null)
@@ -62,6 +63,11 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Gets a list of keys. </summary>
+        /// <param name="name"> A filter for the name of the returned keys. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<KeyListResult, GetKeysHeaders>> GetKeysAsync(string? name, string? after, string? acceptDatetime, CancellationToken cancellationToken = default)
         {
 
@@ -90,6 +96,11 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Gets a list of keys. </summary>
+        /// <param name="name"> A filter for the name of the returned keys. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<KeyListResult, GetKeysHeaders> GetKeys(string? name, string? after, string? acceptDatetime, CancellationToken cancellationToken = default)
         {
 
@@ -144,6 +155,11 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="name"> A filter for the name of the returned keys. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<CheckKeysHeaders>> CheckKeysAsync(string? name, string? after, string? acceptDatetime, CancellationToken cancellationToken = default)
         {
 
@@ -168,6 +184,11 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="name"> A filter for the name of the returned keys. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<CheckKeysHeaders> CheckKeys(string? name, string? after, string? acceptDatetime, CancellationToken cancellationToken = default)
         {
 
@@ -226,6 +247,13 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Gets a list of key-values. </summary>
+        /// <param name="key"> A filter used to match keys. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<KeyValueListResult, GetKeyValuesHeaders>> GetKeyValuesAsync(string? key, string? label, string? after, string? acceptDatetime, IEnumerable<Get6ItemsItem>? select, CancellationToken cancellationToken = default)
         {
 
@@ -254,6 +282,13 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Gets a list of key-values. </summary>
+        /// <param name="key"> A filter used to match keys. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<KeyValueListResult, GetKeyValuesHeaders> GetKeyValues(string? key, string? label, string? after, string? acceptDatetime, IEnumerable<Get6ItemsItem>? select, CancellationToken cancellationToken = default)
         {
 
@@ -316,6 +351,13 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="key"> A filter used to match keys. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<CheckKeyValuesHeaders>> CheckKeyValuesAsync(string? key, string? label, string? after, string? acceptDatetime, IEnumerable<Head6ItemsItem>? select, CancellationToken cancellationToken = default)
         {
 
@@ -340,6 +382,13 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="key"> A filter used to match keys. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<CheckKeyValuesHeaders> CheckKeyValues(string? key, string? label, string? after, string? acceptDatetime, IEnumerable<Head6ItemsItem>? select, CancellationToken cancellationToken = default)
         {
 
@@ -399,6 +448,14 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Gets a single key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<KeyValue, GetKeyValueHeaders>> GetKeyValueAsync(string key, string? label, string? acceptDatetime, string? ifMatch, string? ifNoneMatch, IEnumerable<Get7ItemsItem>? select, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -431,6 +488,14 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Gets a single key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<KeyValue, GetKeyValueHeaders> GetKeyValue(string key, string? label, string? acceptDatetime, string? ifMatch, string? ifNoneMatch, IEnumerable<Get7ItemsItem>? select, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -499,6 +564,13 @@ namespace AppConfiguration
             request.Content = content;
             return message;
         }
+        /// <summary> Creates a key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="entity"> The key-value to create. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<KeyValue, PutKeyValueHeaders>> PutKeyValueAsync(string key, string? label, string? ifMatch, string? ifNoneMatch, KeyValue? entity, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -531,6 +603,13 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Creates a key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="entity"> The key-value to create. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<KeyValue, PutKeyValueHeaders> PutKeyValue(string key, string? label, string? ifMatch, string? ifNoneMatch, KeyValue? entity, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -586,6 +665,11 @@ namespace AppConfiguration
             request.Uri.AppendQuery("api-version", ApiVersion, true);
             return message;
         }
+        /// <summary> Deletes a key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<KeyValue, DeleteKeyValueHeaders>> DeleteKeyValueAsync(string key, string? label, string? ifMatch, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -618,6 +702,11 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Deletes a key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<KeyValue, DeleteKeyValueHeaders> DeleteKeyValue(string key, string? label, string? ifMatch, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -685,6 +774,14 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<CheckKeyValueHeaders>> CheckKeyValueAsync(string key, string? label, string? acceptDatetime, string? ifMatch, string? ifNoneMatch, IEnumerable<Head7ItemsItem>? select, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -713,6 +810,14 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<CheckKeyValueHeaders> CheckKeyValue(string key, string? label, string? acceptDatetime, string? ifMatch, string? ifNoneMatch, IEnumerable<Head7ItemsItem>? select, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -771,6 +876,12 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Gets a list of labels. </summary>
+        /// <param name="name"> A filter for the name of the returned keys. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<LabelListResult, GetLabelsHeaders>> GetLabelsAsync(string? name, string? after, string? acceptDatetime, IEnumerable<string>? select, CancellationToken cancellationToken = default)
         {
 
@@ -799,6 +910,12 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Gets a list of labels. </summary>
+        /// <param name="name"> A filter for the name of the returned keys. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<LabelListResult, GetLabelsHeaders> GetLabels(string? name, string? after, string? acceptDatetime, IEnumerable<string>? select, CancellationToken cancellationToken = default)
         {
 
@@ -857,6 +974,12 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="name"> A filter for the name of the returned keys. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<CheckLabelsHeaders>> CheckLabelsAsync(string? name, string? after, string? acceptDatetime, IEnumerable<string>? select, CancellationToken cancellationToken = default)
         {
 
@@ -881,6 +1004,12 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="name"> A filter for the name of the returned keys. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<CheckLabelsHeaders> CheckLabels(string? name, string? after, string? acceptDatetime, IEnumerable<string>? select, CancellationToken cancellationToken = default)
         {
 
@@ -932,6 +1061,12 @@ namespace AppConfiguration
             request.Uri.AppendQuery("api-version", ApiVersion, true);
             return message;
         }
+        /// <summary> Locks a key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<KeyValue, PutLockHeaders>> PutLockAsync(string key, string? label, string? ifMatch, string? ifNoneMatch, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -964,6 +1099,12 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Locks a key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<KeyValue, PutLockHeaders> PutLock(string key, string? label, string? ifMatch, string? ifNoneMatch, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -1023,6 +1164,12 @@ namespace AppConfiguration
             request.Uri.AppendQuery("api-version", ApiVersion, true);
             return message;
         }
+        /// <summary> Unlocks a key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<KeyValue, DeleteLockHeaders>> DeleteLockAsync(string key, string? label, string? ifMatch, string? ifNoneMatch, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -1055,6 +1202,12 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Unlocks a key-value. </summary>
+        /// <param name="key"> The key of the key-value to retrieve. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="ifMatch"> Used to perform an operation only if the targeted resource&apos;s etag matches the value provided. </param>
+        /// <param name="ifNoneMatch"> Used to perform an operation only if the targeted resource&apos;s etag does not match the value provided. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<KeyValue, DeleteLockHeaders> DeleteLock(string key, string? label, string? ifMatch, string? ifNoneMatch, CancellationToken cancellationToken = default)
         {
             if (key == null)
@@ -1121,6 +1274,13 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Gets a list of key-value revisions. </summary>
+        /// <param name="key"> A filter used to match keys. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<KeyValueListResult, GetRevisionsHeaders>> GetRevisionsAsync(string? key, string? label, string? after, string? acceptDatetime, IEnumerable<Enum0>? select, CancellationToken cancellationToken = default)
         {
 
@@ -1149,6 +1309,13 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Gets a list of key-value revisions. </summary>
+        /// <param name="key"> A filter used to match keys. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<KeyValueListResult, GetRevisionsHeaders> GetRevisions(string? key, string? label, string? after, string? acceptDatetime, IEnumerable<Enum0>? select, CancellationToken cancellationToken = default)
         {
 
@@ -1211,6 +1378,13 @@ namespace AppConfiguration
             }
             return message;
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="key"> A filter used to match keys. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<ResponseWithHeaders<CheckRevisionsHeaders>> CheckRevisionsAsync(string? key, string? label, string? after, string? acceptDatetime, IEnumerable<Enum0>? select, CancellationToken cancellationToken = default)
         {
 
@@ -1235,6 +1409,13 @@ namespace AppConfiguration
                 throw;
             }
         }
+        /// <summary> Requests the headers and status of the given resource. </summary>
+        /// <param name="key"> A filter used to match keys. </param>
+        /// <param name="label"> A filter used to match labels. </param>
+        /// <param name="after"> Instructs the server to return elements that appear after the element referred to by the specified token. </param>
+        /// <param name="acceptDatetime"> Requests the server to respond with the state of the resource at the specified time. </param>
+        /// <param name="select"> Used to select what fields are present in the returned resource(s). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public ResponseWithHeaders<CheckRevisionsHeaders> CheckRevisions(string? key, string? label, string? after, string? acceptDatetime, IEnumerable<Enum0>? select, CancellationToken cancellationToken = default)
         {
 

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DetectedLanguage.cs

@@ -3,10 +3,14 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DetectedLanguage
     {
+        /// <summary> Long name of a detected language (e.g. English, French). </summary>
         public string Name { get; set; }
+        /// <summary> A two letter representation of the detected language according to the ISO 639-1 standard (e.g. en, fr). </summary>
         public string Iso6391Name { get; set; }
+        /// <summary> A confidence score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true. </summary>
         public double Score { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentEntities.cs

@@ -5,10 +5,14 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DocumentEntities
     {
+        /// <summary> Unique, non-empty document identifier. </summary>
         public string Id { get; set; }
+        /// <summary> Recognized entities in the document. </summary>
         public ICollection<Entity> Entities { get; set; } = new List<Entity>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the document payload. </summary>
         public DocumentStatistics? Statistics { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentError.cs

@@ -3,9 +3,12 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DocumentError
     {
+        /// <summary> Document Id. </summary>
         public string Id { get; set; }
+        /// <summary> Document Error. </summary>
         public DocumentErrorError Error { get; set; } = new DocumentErrorError();
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentErrorError.cs

@@ -3,6 +3,7 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> Document Error. </summary>
     public partial class DocumentErrorError
     {
     }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentKeyPhrases.cs

@@ -5,10 +5,14 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DocumentKeyPhrases
     {
+        /// <summary> Unique, non-empty document identifier. </summary>
         public string Id { get; set; }
+        /// <summary> A list of representative words or phrases. The number of key phrases returned is proportional to the number of words in the input document. </summary>
         public ICollection<string> KeyPhrases { get; set; } = new List<string>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the document payload. </summary>
         public DocumentStatistics? Statistics { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentLanguage.cs

@@ -5,10 +5,14 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DocumentLanguage
     {
+        /// <summary> Unique, non-empty document identifier. </summary>
         public string Id { get; set; }
+        /// <summary> A list of extracted languages. </summary>
         public ICollection<DetectedLanguage> DetectedLanguages { get; set; } = new List<DetectedLanguage>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the document payload. </summary>
         public DocumentStatistics? Statistics { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentLinkedEntities.cs

@@ -5,10 +5,14 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DocumentLinkedEntities
     {
+        /// <summary> Unique, non-empty document identifier. </summary>
         public string Id { get; set; }
+        /// <summary> Recognized well-known entities in the document. </summary>
         public ICollection<LinkedEntity> Entities { get; set; } = new List<LinkedEntity>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the document payload. </summary>
         public DocumentStatistics? Statistics { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentSentiment.cs

@@ -5,12 +5,18 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DocumentSentiment
     {
+        /// <summary> Unique, non-empty document identifier. </summary>
         public string Id { get; set; }
+        /// <summary> Predicted sentiment for document (Negative, Neutral, Positive, or Mixed). </summary>
         public DocumentSentimentSentiment Sentiment { get; set; }
+        /// <summary> if showStats=true was specified in the request this field will contain information about the document payload. </summary>
         public DocumentStatistics? Statistics { get; set; }
+        /// <summary> &lt;Any object&gt;. </summary>
         public object DocumentScores { get; set; }
+        /// <summary> Sentence level sentiment analysis. </summary>
         public ICollection<SentenceSentiment> Sentences { get; set; } = new List<SentenceSentiment>();
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentSentimentSentiment.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> Predicted sentiment for document (Negative, Neutral, Positive, or Mixed). </summary>
     public readonly partial struct DocumentSentimentSentiment : IEquatable<DocumentSentimentSentiment>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="DocumentSentimentSentiment"/> values are the same. </summary>
         public DocumentSentimentSentiment(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -20,20 +22,31 @@ namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
         private const string NegativeValue = "negative";
         private const string MixedValue = "mixed";
 
+        /// <summary> positive. </summary>
         public static DocumentSentimentSentiment Positive { get; } = new DocumentSentimentSentiment(PositiveValue);
+        /// <summary> neutral. </summary>
         public static DocumentSentimentSentiment Neutral { get; } = new DocumentSentimentSentiment(NeutralValue);
+        /// <summary> negative. </summary>
         public static DocumentSentimentSentiment Negative { get; } = new DocumentSentimentSentiment(NegativeValue);
+        /// <summary> mixed. </summary>
         public static DocumentSentimentSentiment Mixed { get; } = new DocumentSentimentSentiment(MixedValue);
+        /// <summary> Determines if two <see cref="DocumentSentimentSentiment"/> values are the same. </summary>
         public static bool operator ==(DocumentSentimentSentiment left, DocumentSentimentSentiment right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="DocumentSentimentSentiment"/> values are not the same. </summary>
         public static bool operator !=(DocumentSentimentSentiment left, DocumentSentimentSentiment right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="DocumentSentimentSentiment"/>. </summary>
         public static implicit operator DocumentSentimentSentiment(string value) => new DocumentSentimentSentiment(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is DocumentSentimentSentiment other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(DocumentSentimentSentiment other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/DocumentStatistics.cs

@@ -3,9 +3,12 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> if showStats=true was specified in the request this field will contain information about the document payload. </summary>
     public partial class DocumentStatistics
     {
+        /// <summary> Number of text elements recognized in the document. </summary>
         public int CharactersCount { get; set; }
+        /// <summary> Number of transactions for the document. </summary>
         public int TransactionsCount { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/EntitiesResult.cs

@@ -5,11 +5,16 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class EntitiesResult
     {
+        /// <summary> Response by document. </summary>
         public ICollection<DocumentEntities> Documents { get; set; } = new List<DocumentEntities>();
+        /// <summary> Errors by document id. </summary>
         public ICollection<DocumentError> Errors { get; set; } = new List<DocumentError>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the request payload. </summary>
         public RequestStatistics? Statistics { get; set; }
+        /// <summary> This field indicates which model is used for scoring. </summary>
         public string ModelVersion { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/Entity.cs

@@ -3,13 +3,20 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Entity
     {
+        /// <summary> Entity text as appears in the request. </summary>
         public string Text { get; set; }
+        /// <summary> Entity type, such as Person/Location/Org/SSN etc. </summary>
         public string Type { get; set; }
+        /// <summary> Entity sub type, such as Age/Year/TimeRange etc. </summary>
         public string? SubType { get; set; }
+        /// <summary> Start position (in Unicode characters) for the entity text. </summary>
         public int Offset { get; set; }
+        /// <summary> Length (in Unicode characters) for the entity text. </summary>
         public int Length { get; set; }
+        /// <summary> Confidence score between 0 and 1 of the extracted entity. </summary>
         public double Score { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/EntityLinkingResult.cs

@@ -5,11 +5,16 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class EntityLinkingResult
     {
+        /// <summary> Response by document. </summary>
         public ICollection<DocumentLinkedEntities> Documents { get; set; } = new List<DocumentLinkedEntities>();
+        /// <summary> Errors by document id. </summary>
         public ICollection<DocumentError> Errors { get; set; } = new List<DocumentError>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the request payload. </summary>
         public RequestStatistics? Statistics { get; set; }
+        /// <summary> This field indicates which model is used for scoring. </summary>
         public string ModelVersion { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/Error.cs

@@ -5,12 +5,18 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Error
     {
+        /// <summary> Error code. </summary>
         public ErrorCode Code { get; set; }
+        /// <summary> Error message. </summary>
         public string Message { get; set; }
+        /// <summary> Error target. </summary>
         public string? Target { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
         public InnerError? Innererror { get; set; }
+        /// <summary> Details about specific errors that led to this reported error. </summary>
         public ICollection<Error>? Details { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/ErrorCode.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> Error code. </summary>
     public readonly partial struct ErrorCode : IEquatable<ErrorCode>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="ErrorCode"/> values are the same. </summary>
         public ErrorCode(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -20,20 +22,31 @@ namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
         private const string InternalServerErrorValue = "internalServerError";
         private const string ServiceUnavailableValue = "serviceUnavailable";
 
+        /// <summary> invalidRequest. </summary>
         public static ErrorCode InvalidRequest { get; } = new ErrorCode(InvalidRequestValue);
+        /// <summary> invalidArgument. </summary>
         public static ErrorCode InvalidArgument { get; } = new ErrorCode(InvalidArgumentValue);
+        /// <summary> internalServerError. </summary>
         public static ErrorCode InternalServerError { get; } = new ErrorCode(InternalServerErrorValue);
+        /// <summary> serviceUnavailable. </summary>
         public static ErrorCode ServiceUnavailable { get; } = new ErrorCode(ServiceUnavailableValue);
+        /// <summary> Determines if two <see cref="ErrorCode"/> values are the same. </summary>
         public static bool operator ==(ErrorCode left, ErrorCode right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="ErrorCode"/> values are not the same. </summary>
         public static bool operator !=(ErrorCode left, ErrorCode right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="ErrorCode"/>. </summary>
         public static implicit operator ErrorCode(string value) => new ErrorCode(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is ErrorCode other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(ErrorCode other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/InnerError.cs

@@ -3,11 +3,16 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class InnerError
     {
+        /// <summary> Error code. </summary>
         public InnerErrorCode Code { get; set; }
+        /// <summary> Error message. </summary>
         public string Message { get; set; }
+        /// <summary> Error target. </summary>
         public string? Target { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
         public InnerError? Innererror { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/InnerErrorCode.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> Error code. </summary>
     public readonly partial struct InnerErrorCode : IEquatable<InnerErrorCode>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="InnerErrorCode"/> values are the same. </summary>
         public InnerErrorCode(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -25,25 +27,41 @@ namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
         private const string UnsupportedLanguageCodeValue = "unsupportedLanguageCode";
         private const string InvalidCountryHintValue = "invalidCountryHint";
 
+        /// <summary> invalidParameterValue. </summary>
         public static InnerErrorCode InvalidParameterValue { get; } = new InnerErrorCode(InvalidParameterValueValue);
+        /// <summary> invalidRequestBodyFormat. </summary>
         public static InnerErrorCode InvalidRequestBodyFormat { get; } = new InnerErrorCode(InvalidRequestBodyFormatValue);
+        /// <summary> emptyRequest. </summary>
         public static InnerErrorCode EmptyRequest { get; } = new InnerErrorCode(EmptyRequestValue);
+        /// <summary> missingInputRecords. </summary>
         public static InnerErrorCode MissingInputRecords { get; } = new InnerErrorCode(MissingInputRecordsValue);
+        /// <summary> invalidDocument. </summary>
         public static InnerErrorCode InvalidDocument { get; } = new InnerErrorCode(InvalidDocumentValue);
+        /// <summary> modelVersionIncorrect. </summary>
         public static InnerErrorCode ModelVersionIncorrect { get; } = new InnerErrorCode(ModelVersionIncorrectValue);
+        /// <summary> invalidDocumentBatch. </summary>
         public static InnerErrorCode InvalidDocumentBatch { get; } = new InnerErrorCode(InvalidDocumentBatchValue);
+        /// <summary> unsupportedLanguageCode. </summary>
         public static InnerErrorCode UnsupportedLanguageCode { get; } = new InnerErrorCode(UnsupportedLanguageCodeValue);
+        /// <summary> invalidCountryHint. </summary>
         public static InnerErrorCode InvalidCountryHint { get; } = new InnerErrorCode(InvalidCountryHintValue);
+        /// <summary> Determines if two <see cref="InnerErrorCode"/> values are the same. </summary>
         public static bool operator ==(InnerErrorCode left, InnerErrorCode right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="InnerErrorCode"/> values are not the same. </summary>
         public static bool operator !=(InnerErrorCode left, InnerErrorCode right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="InnerErrorCode"/>. </summary>
         public static implicit operator InnerErrorCode(string value) => new InnerErrorCode(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is InnerErrorCode other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(InnerErrorCode other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/KeyPhraseResult.cs

@@ -5,11 +5,16 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class KeyPhraseResult
     {
+        /// <summary> Response by document. </summary>
         public ICollection<DocumentKeyPhrases> Documents { get; set; } = new List<DocumentKeyPhrases>();
+        /// <summary> Errors by document id. </summary>
         public ICollection<DocumentError> Errors { get; set; } = new List<DocumentError>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the request payload. </summary>
         public RequestStatistics? Statistics { get; set; }
+        /// <summary> This field indicates which model is used for scoring. </summary>
         public string ModelVersion { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/LanguageBatchInput.cs

@@ -5,8 +5,10 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class LanguageBatchInput
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-ARRAYSCHEMA. </summary>
         public ICollection<LanguageInput> Documents { get; set; } = new List<LanguageInput>();
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/LanguageInput.cs

@@ -3,10 +3,14 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class LanguageInput
     {
+        /// <summary> Unique, non-empty document identifier. </summary>
         public string Id { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string Text { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? CountryHint { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/LanguageResult.cs

@@ -5,11 +5,16 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class LanguageResult
     {
+        /// <summary> Response by document. </summary>
         public ICollection<DocumentLanguage> Documents { get; set; } = new List<DocumentLanguage>();
+        /// <summary> Errors by document id. </summary>
         public ICollection<DocumentError> Errors { get; set; } = new List<DocumentError>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the request payload. </summary>
         public RequestStatistics? Statistics { get; set; }
+        /// <summary> This field indicates which model is used for scoring. </summary>
         public string ModelVersion { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/LinkedEntity.cs

@@ -5,13 +5,20 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class LinkedEntity
     {
+        /// <summary> Entity Linking formal name. </summary>
         public string Name { get; set; }
+        /// <summary> List of instances this entity appears in the text. </summary>
         public ICollection<Match> Matches { get; set; } = new List<Match>();
+        /// <summary> Language used in the data source. </summary>
         public string Language { get; set; }
+        /// <summary> Unique identifier of the recognized entity from the data source. </summary>
         public string? Id { get; set; }
+        /// <summary> URL for the entity&apos;s page from the data source. </summary>
         public string Url { get; set; }
+        /// <summary> Data source used to extract entity linking, such as Wiki/Bing etc. </summary>
         public string DataSource { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/Match.cs

@@ -3,11 +3,16 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Match
     {
+        /// <summary> If a well-known item is recognized, a decimal number denoting the confidence level between 0 and 1 will be returned. </summary>
         public double Score { get; set; }
+        /// <summary> Entity text as appears in the request. </summary>
         public string Text { get; set; }
+        /// <summary> Start position (in Unicode characters) for the entity match text. </summary>
         public int Offset { get; set; }
+        /// <summary> Length (in Unicode characters) for the entity match text. </summary>
         public int Length { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/MultiLanguageBatchInput.cs

@@ -5,8 +5,10 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> Contains a set of input documents to be analyzed by the service. </summary>
     public partial class MultiLanguageBatchInput
     {
+        /// <summary> The set of documents to process as part of this batch. </summary>
         public ICollection<MultiLanguageInput> Documents { get; set; } = new List<MultiLanguageInput>();
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/MultiLanguageInput.cs

@@ -3,10 +3,14 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> Contains an input document to be analyzed by the service. </summary>
     public partial class MultiLanguageInput
     {
+        /// <summary> A unique, non-empty document identifier. </summary>
         public string Id { get; set; }
+        /// <summary> The input text to process. </summary>
         public string Text { get; set; }
+        /// <summary> (Optional) This is the 2 letter ISO 639-1 representation of a language. For example, use &quot;en&quot; for English; &quot;es&quot; for Spanish etc. If not set, use &quot;en&quot; for English as default. </summary>
         public string? Language { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/RequestStatistics.cs

@@ -3,11 +3,16 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> if showStats=true was specified in the request this field will contain information about the request payload. </summary>
     public partial class RequestStatistics
     {
+        /// <summary> Number of documents submitted in the request. </summary>
         public int DocumentsCount { get; set; }
+        /// <summary> Number of valid documents. This excludes empty, over-size limit or non-supported languages documents. </summary>
         public int ValidDocumentsCount { get; set; }
+        /// <summary> Number of invalid documents. This includes empty, over-size limit or non-supported languages documents. </summary>
         public int ErroneousDocumentsCount { get; set; }
+        /// <summary> Number of transactions for the request. </summary>
         public long TransactionsCount { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/SentenceSentiment.cs

@@ -5,12 +5,18 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class SentenceSentiment
     {
+        /// <summary> The predicted Sentiment for the sentence. </summary>
         public SentenceSentimentSentiment Sentiment { get; set; }
+        /// <summary> &lt;Any object&gt;. </summary>
         public object SentenceScores { get; set; }
+        /// <summary> The sentence offset from the start of the document. </summary>
         public int Offset { get; set; }
+        /// <summary> The length of the sentence by Unicode standard. </summary>
         public int Length { get; set; }
+        /// <summary> The warnings generated for the sentence. </summary>
         public ICollection<string> Warnings { get; set; } = new List<string>();
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/SentenceSentimentSentiment.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> The predicted Sentiment for the sentence. </summary>
     public readonly partial struct SentenceSentimentSentiment : IEquatable<SentenceSentimentSentiment>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="SentenceSentimentSentiment"/> values are the same. </summary>
         public SentenceSentimentSentiment(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -19,19 +21,29 @@ namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
         private const string NeutralValue = "neutral";
         private const string NegativeValue = "negative";
 
+        /// <summary> positive. </summary>
         public static SentenceSentimentSentiment Positive { get; } = new SentenceSentimentSentiment(PositiveValue);
+        /// <summary> neutral. </summary>
         public static SentenceSentimentSentiment Neutral { get; } = new SentenceSentimentSentiment(NeutralValue);
+        /// <summary> negative. </summary>
         public static SentenceSentimentSentiment Negative { get; } = new SentenceSentimentSentiment(NegativeValue);
+        /// <summary> Determines if two <see cref="SentenceSentimentSentiment"/> values are the same. </summary>
         public static bool operator ==(SentenceSentimentSentiment left, SentenceSentimentSentiment right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="SentenceSentimentSentiment"/> values are not the same. </summary>
         public static bool operator !=(SentenceSentimentSentiment left, SentenceSentimentSentiment right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="SentenceSentimentSentiment"/>. </summary>
         public static implicit operator SentenceSentimentSentiment(string value) => new SentenceSentimentSentiment(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is SentenceSentimentSentiment other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(SentenceSentimentSentiment other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/SentimentConfidenceScorePerLabel.cs

@@ -3,10 +3,14 @@
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative. </summary>
     public partial class SentimentConfidenceScorePerLabel
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-NUMBER. </summary>
         public double Positive { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-NUMBER. </summary>
         public double Neutral { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-NUMBER. </summary>
         public double Negative { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Models/SentimentResponse.cs

@@ -5,11 +5,16 @@ using System.Collections.Generic;
 
 namespace CognitiveServices.TextAnalytics.Models.VV30Preview1
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class SentimentResponse
     {
+        /// <summary> Sentiment analysis per document. </summary>
         public ICollection<DocumentSentiment> Documents { get; set; } = new List<DocumentSentiment>();
+        /// <summary> Errors by document id. </summary>
         public ICollection<DocumentError> Errors { get; set; } = new List<DocumentError>();
+        /// <summary> if showStats=true was specified in the request this field will contain information about the request payload. </summary>
         public RequestStatistics? Statistics { get; set; }
+        /// <summary> This field indicates which model is used for scoring. </summary>
         public string ModelVersion { get; set; }
     }
 }

samples/CognitiveServices.TextAnalytics/CognitiveServices.TextAnalytics/Generated/Operations/AllOperations.cs

@@ -17,6 +17,7 @@ namespace CognitiveServices.TextAnalytics
         private string endpoint;
         private ClientDiagnostics clientDiagnostics;
         private HttpPipeline pipeline;
+        /// <summary> Initializes a new instance of AllOperations. </summary>
         public AllOperations(ClientDiagnostics clientDiagnostics, HttpPipeline pipeline, string endpoint)
         {
             if (endpoint == null)
@@ -50,6 +51,14 @@ namespace CognitiveServices.TextAnalytics
             request.Content = content;
             return message;
         }
+        /// <summary>
+        /// The API returns a list of general named entities in a given document. For the list of supported entity types, check &lt;a href=&quot;https://aka.ms/taner&quot;&gt;Supported Entity Types in Text Analytics API&lt;/a&gt;. For the list of enabled languages, check &lt;a href=&quot;https://aka.ms/talangs&quot;&gt;Supported languages in Text Analytics API&lt;/a&gt;.
+        /// .
+        /// </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<EntitiesResult>> EntitiesRecognitionGeneralAsync(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -81,6 +90,14 @@ namespace CognitiveServices.TextAnalytics
                 throw;
             }
         }
+        /// <summary>
+        /// The API returns a list of general named entities in a given document. For the list of supported entity types, check &lt;a href=&quot;https://aka.ms/taner&quot;&gt;Supported Entity Types in Text Analytics API&lt;/a&gt;. For the list of enabled languages, check &lt;a href=&quot;https://aka.ms/talangs&quot;&gt;Supported languages in Text Analytics API&lt;/a&gt;.
+        /// .
+        /// </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<EntitiesResult> EntitiesRecognitionGeneral(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -134,6 +151,14 @@ namespace CognitiveServices.TextAnalytics
             request.Content = content;
             return message;
         }
+        /// <summary>
+        /// The API returns a list of entities with personal information (\&quot;SSN\&quot;, \&quot;Bank Account\&quot; etc) in the document. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API&amp;lt;/a&amp;gt; for the list of enabled languages.
+        /// .
+        /// </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<EntitiesResult>> EntitiesRecognitionPiiAsync(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -165,6 +190,14 @@ namespace CognitiveServices.TextAnalytics
                 throw;
             }
         }
+        /// <summary>
+        /// The API returns a list of entities with personal information (\&quot;SSN\&quot;, \&quot;Bank Account\&quot; etc) in the document. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API&amp;lt;/a&amp;gt; for the list of enabled languages.
+        /// .
+        /// </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<EntitiesResult> EntitiesRecognitionPii(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -218,6 +251,14 @@ namespace CognitiveServices.TextAnalytics
             request.Content = content;
             return message;
         }
+        /// <summary>
+        /// The API returns a list of recognized entities with links to a well-known knowledge base. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API.
+        /// .
+        /// </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<EntityLinkingResult>> EntitiesLinkingAsync(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -249,6 +290,14 @@ namespace CognitiveServices.TextAnalytics
                 throw;
             }
         }
+        /// <summary>
+        /// The API returns a list of recognized entities with links to a well-known knowledge base. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API.
+        /// .
+        /// </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<EntityLinkingResult> EntitiesLinking(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -302,6 +351,11 @@ namespace CognitiveServices.TextAnalytics
             request.Content = content;
             return message;
         }
+        /// <summary> The API returns a list of strings denoting the key phrases in the input text. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API&amp;lt;/a&amp;gt; for the list of enabled languages. </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<KeyPhraseResult>> KeyPhrasesAsync(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -333,6 +387,11 @@ namespace CognitiveServices.TextAnalytics
                 throw;
             }
         }
+        /// <summary> The API returns a list of strings denoting the key phrases in the input text. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API&amp;lt;/a&amp;gt; for the list of enabled languages. </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<KeyPhraseResult> KeyPhrases(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -386,6 +445,11 @@ namespace CognitiveServices.TextAnalytics
             request.Content = content;
             return message;
         }
+        /// <summary> The API returns the detected language and a numeric score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API&amp;lt;/a&amp;gt; for the list of enabled languages. </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="languageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<LanguageResult>> LanguagesAsync(string? modelVersion, bool? showStats, LanguageBatchInput languageBatchInput, CancellationToken cancellationToken = default)
         {
             if (languageBatchInput == null)
@@ -417,6 +481,11 @@ namespace CognitiveServices.TextAnalytics
                 throw;
             }
         }
+        /// <summary> The API returns the detected language and a numeric score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API&amp;lt;/a&amp;gt; for the list of enabled languages. </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="languageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<LanguageResult> Languages(string? modelVersion, bool? showStats, LanguageBatchInput languageBatchInput, CancellationToken cancellationToken = default)
         {
             if (languageBatchInput == null)
@@ -470,6 +539,11 @@ namespace CognitiveServices.TextAnalytics
             request.Content = content;
             return message;
         }
+        /// <summary> The API returns a sentiment prediction, as well as sentiment scores for each sentiment class (Positive, Negative, and Neutral) for the document and each sentence within it. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API&amp;lt;/a&amp;gt; for the list of enabled languages. </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<SentimentResponse>> SentimentAsync(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)
@@ -501,6 +575,11 @@ namespace CognitiveServices.TextAnalytics
                 throw;
             }
         }
+        /// <summary> The API returns a sentiment prediction, as well as sentiment scores for each sentiment class (Positive, Negative, and Neutral) for the document and each sentence within it. See the &amp;lt;a href=&quot;https://aka.ms/talangs&quot;&amp;gt;Supported languages in Text Analytics API&amp;lt;/a&amp;gt; for the list of enabled languages. </summary>
+        /// <param name="modelVersion"> (Optional) This value indicates which model will be used for scoring. If a model-version is not specified, the API should default to the latest, non-preview version. </param>
+        /// <param name="showStats"> (Optional) if set to true, response will contain input and document level statistics. </param>
+        /// <param name="multiLanguageBatchInput"> Collection of documents to analyze. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<SentimentResponse> Sentiment(string? modelVersion, bool? showStats, MultiLanguageBatchInput multiLanguageBatchInput, CancellationToken cancellationToken = default)
         {
             if (multiLanguageBatchInput == null)

src/AutoRest.CSharp.V3/ClientModels/ClientBuilder.cs

@@ -44,6 +44,7 @@ namespace AutoRest.CSharp.V3.ClientModels
             }
 
             return new ServiceClient(clientName,
+                arg.Language.Default.Description,
                 OrderParameters(clientParameters.Values),
                 methods.ToArray());
         }
@@ -186,6 +187,7 @@ namespace AutoRest.CSharp.V3.ClientModels
             string operationName = operation.CSharpName();
             return new ClientMethod(
                 operationName,
+                ClientModelBuilderHelpers.EscapeXmlDescription(operation.Language.Default.Description),
                 request,
                 OrderParameters(methodParameters),
                 clientResponse,
@@ -203,6 +205,7 @@ namespace AutoRest.CSharp.V3.ClientModels
 
             return new ServiceClientParameter(
                 requestParameter.CSharpName(),
+                CreateDescription(requestParameter),
                 ClientModelBuilderHelpers.CreateType(requestParameter.Schema, requestParameter.IsNullable()),
                 CreateDefaultValueConstant(requestParameter) ?? defaultValue,
                 requestParameter.Required == true);
@@ -218,8 +221,11 @@ namespace AutoRest.CSharp.V3.ClientModels
             ResponseHeader CreateResponseHeader(HttpHeader header) =>
                 new ResponseHeader(header.Header.ToCleanName(), header.Header, ClientModelBuilderHelpers.CreateType(header.Schema, true));
 
+            string operationName = operation.CSharpName();
+
             return new ResponseHeaderModel(
-                operation.CSharpName() + "Headers",
+                operationName + "Headers",
+                $"Header model for {operationName}",
                 httpResponse.Headers.Select(CreateResponseHeader).ToArray()
                 );
         }
@@ -286,5 +292,11 @@ namespace AutoRest.CSharp.V3.ClientModels
             _ => null
         };
 
+        private static string CreateDescription(Parameter requestParameter)
+        {
+            return string.IsNullOrWhiteSpace(requestParameter.Language.Default.Description) ?
+                $"The {requestParameter.Schema.Name} to use." :
+                ClientModelBuilderHelpers.EscapeXmlDescription(requestParameter.Language.Default.Description);
+        }
     }
 }

src/AutoRest.CSharp.V3/ClientModels/ClientEnum.cs

@@ -8,10 +8,11 @@ namespace AutoRest.CSharp.V3.ClientModels
 {
     internal class ClientEnum : ClientModel, ISchemaTypeProvider
     {
-        public ClientEnum(Schema schema, string name, IEnumerable<ClientEnumValue> values, bool isStringBased = false)
+        public ClientEnum(Schema schema, string name, string? description, IEnumerable<ClientEnumValue> values, bool isStringBased = false)
         {
             Schema = schema;
             Name = name;
+            Description = description;
             Values = new List<ClientEnumValue>(values);
             IsStringBased = isStringBased;
         }
@@ -19,6 +20,7 @@ namespace AutoRest.CSharp.V3.ClientModels
         public bool IsStringBased { get; }
         public Schema Schema { get; }
         public override string Name { get; }
+        public string? Description { get; }
         public IList<ClientEnumValue> Values { get; }
     }
 }

src/AutoRest.CSharp.V3/ClientModels/ClientEnumValue.cs

@@ -5,13 +5,15 @@ namespace AutoRest.CSharp.V3.ClientModels
 {
     internal class ClientEnumValue
     {
-        public ClientEnumValue(string name, ClientConstant value)
+        public ClientEnumValue(string name, string description, ClientConstant value)
         {
             Name = name;
+            Description = description;
             Value = value;
         }
 
         public string Name { get; }
         public ClientConstant Value { get; }
+        public string Description { get; }
     }
 }

src/AutoRest.CSharp.V3/ClientModels/ClientMethod.cs

@@ -5,17 +5,19 @@ namespace AutoRest.CSharp.V3.ClientModels
 {
     internal class ClientMethod
     {
-        public ClientMethod(string name, ClientMethodRequest request, ServiceClientParameter[] parameters, ClientMethodResponse responseType, ClientMethodDiagnostics diagnostics)
+        public ClientMethod(string name, string? description, ClientMethodRequest request, ServiceClientParameter[] parameters, ClientMethodResponse responseType, ClientMethodDiagnostics diagnostics)
         {
             Name = name;
             Request = request;
             Parameters = parameters;
             Response = responseType;
+            Description = description;
             Diagnostics = diagnostics;
         }
 
         public string Name { get; }
 
+        public string? Description { get; }
         public ClientMethodRequest Request { get; }
         public ServiceClientParameter[] Parameters { get; }
         public ClientMethodResponse Response { get; }

src/AutoRest.CSharp.V3/ClientModels/ClientModelBuilderHelpers.cs

@@ -3,6 +3,7 @@
 
 using System;
 using System.Globalization;
+using System.Security;
 using System.Xml;
 using AutoRest.CSharp.V3.ClientModels.Serialization;
 using AutoRest.CSharp.V3.Pipeline.Generated;
@@ -92,5 +93,10 @@ namespace AutoRest.CSharp.V3.ClientModels
         {
             return ParseClientConstant(constant.Value.Value, CreateType(constant.ValueType, constant.Value.Value == null));
         }
+
+        public static string EscapeXmlDescription(string s)
+        {
+            return SecurityElement.Escape(s) ?? s;
+        }
     }
 }

src/AutoRest.CSharp.V3/ClientModels/ClientObject.cs

@@ -9,10 +9,11 @@ namespace AutoRest.CSharp.V3.ClientModels
 {
     internal class ClientObject : ClientModel, ISchemaTypeProvider
     {
-        public ClientObject(Schema schema, string name, SchemaTypeReference? inherits, IEnumerable<ClientObjectProperty> properties, ClientObjectDiscriminator? discriminator, DictionaryTypeReference? implementsDictionary, ObjectSerialization[] serializations)
+        public ClientObject(Schema schema, string name, string? description, SchemaTypeReference? inherits, IEnumerable<ClientObjectProperty> properties, ClientObjectDiscriminator? discriminator, DictionaryTypeReference? implementsDictionary, ObjectSerialization[] serializations)
         {
             Schema = schema;
             Name = name;
+            Description = description;
             Inherits = inherits;
             Discriminator = discriminator;
             ImplementsDictionary = implementsDictionary;
@@ -21,6 +22,7 @@ namespace AutoRest.CSharp.V3.ClientModels
         }
 
         public override string Name { get; }
+        public string? Description { get; }
         public Schema Schema { get; }
         public SchemaTypeReference? Inherits { get; }
         public ObjectSerialization[] Serializations { get; }

src/AutoRest.CSharp.V3/ClientModels/ClientObjectProperty.cs

@@ -5,15 +5,17 @@ namespace AutoRest.CSharp.V3.ClientModels
 {
     internal class ClientObjectProperty
     {
-        public ClientObjectProperty(string name, ClientTypeReference type, bool isReadOnly, ClientConstant? defaultValue = null)
+        public ClientObjectProperty(string name, string description, ClientTypeReference type, bool isReadOnly, ClientConstant? defaultValue = null)
         {
             Name = name;
+            Description = description;
             Type = type;
             IsReadOnly = isReadOnly;
             DefaultValue = defaultValue;
         }
 
         public string Name { get; }
+        public string Description { get; }
         public ClientConstant? DefaultValue { get; }
         public ClientTypeReference Type { get; }
         public bool IsReadOnly { get; }

src/AutoRest.CSharp.V3/ClientModels/ModelBuilder.cs

@@ -25,12 +25,20 @@ namespace AutoRest.CSharp.V3.ClientModels
         private static ClientModel BuildClientEnum(SealedChoiceSchema sealedChoiceSchema) => new ClientEnum(
             sealedChoiceSchema,
             sealedChoiceSchema.CSharpName(),
-            sealedChoiceSchema.Choices.Select(c => new ClientEnumValue(c.CSharpName(), ClientModelBuilderHelpers.StringConstant(c.Value))));
+            CreateDescription(sealedChoiceSchema),
+            sealedChoiceSchema.Choices.Select(c => new ClientEnumValue(
+                c.CSharpName(),
+                CreateDescription(c),
+                ClientModelBuilderHelpers.StringConstant(c.Value))));
 
         private static ClientModel BuildClientEnum(ChoiceSchema choiceSchema) => new ClientEnum(
             choiceSchema,
             choiceSchema.CSharpName(),
-            choiceSchema.Choices.Select(c => new ClientEnumValue(c.CSharpName(), ClientModelBuilderHelpers.StringConstant(c.Value))),
+            CreateDescription(choiceSchema),
+            choiceSchema.Choices.Select(c => new ClientEnumValue(
+                c.CSharpName(),
+                CreateDescription(c),
+                ClientModelBuilderHelpers.StringConstant(c.Value))),
             true);
 
         private ClientModel BuildClientObject(ObjectSchema objectSchema)
@@ -85,11 +93,10 @@ namespace AutoRest.CSharp.V3.ClientModels
                     );
             }
 
-            var schemaTypeReference = ClientModelBuilderHelpers.CreateType(objectSchema, false);
-
             return new ClientObject(
                 objectSchema,
                 objectSchema.CSharpName(),
+                CreateDescription(objectSchema),
                 (SchemaTypeReference?) inheritsFromTypeReference,
                 properties.ToArray(),
                 discriminator,
@@ -150,9 +157,24 @@ namespace AutoRest.CSharp.V3.ClientModels
             }
 
             return new ClientObjectProperty(property.CSharpName(),
+                ClientModelBuilderHelpers.EscapeXmlDescription(property.Language.Default.Description),
                 type,
                 isReadOnly,
                 defaultValue);
         }
+
+        private static string CreateDescription(ChoiceValue choiceValue)
+        {
+            return string.IsNullOrWhiteSpace(choiceValue.Language.Default.Description) ?
+                choiceValue.Value :
+                ClientModelBuilderHelpers.EscapeXmlDescription(choiceValue.Language.Default.Description);
+        }
+
+        private static string CreateDescription(Schema objectSchema)
+        {
+            return string.IsNullOrWhiteSpace(objectSchema.Language.Default.Description) ?
+                $"The {objectSchema.Name}." :
+                ClientModelBuilderHelpers.EscapeXmlDescription(objectSchema.Language.Default.Description);
+        }
     }
 }

src/AutoRest.CSharp.V3/ClientModels/ResponseHeaderModel.cs

@@ -5,14 +5,17 @@ namespace AutoRest.CSharp.V3.ClientModels
 {
     internal class ResponseHeaderModel
     {
-        public ResponseHeaderModel(string name, ResponseHeader[] headers)
+        public ResponseHeaderModel(string name, string description, ResponseHeader[] headers)
         {
             Name = name;
             Headers = headers;
+            Description = description;
         }
 
         public string Name { get; }
 
+        public string Description { get; }
+
         public ResponseHeader[] Headers { get; }
     }
 }

src/AutoRest.CSharp.V3/ClientModels/ServiceClient.cs

@@ -5,14 +5,16 @@ namespace AutoRest.CSharp.V3.ClientModels
 {
     internal class ServiceClient
     {
-        public ServiceClient(string name, ServiceClientParameter[] parameters, ClientMethod[] methods)
+        public ServiceClient(string name, string description, ServiceClientParameter[] parameters, ClientMethod[] methods)
         {
             Name = name;
             Parameters = parameters;
             Methods = methods;
+            Description = description;
         }
 
         public string Name { get; }
+        public string Description { get; }
 
         public ClientMethod[] Methods { get; }
 

src/AutoRest.CSharp.V3/ClientModels/ServiceClientParameter.cs

@@ -5,9 +5,10 @@ namespace AutoRest.CSharp.V3.ClientModels
 {
     internal class ServiceClientParameter
     {
-        public ServiceClientParameter(string name, ClientTypeReference type, ClientConstant? defaultValue, bool isRequired)
+        public ServiceClientParameter(string name, string? description, ClientTypeReference type, ClientConstant? defaultValue, bool isRequired)
         {
             Name = name;
+            Description = description;
             Type = type;
             DefaultValue = defaultValue;
             IsRequired = isRequired;
@@ -15,6 +16,7 @@ namespace AutoRest.CSharp.V3.ClientModels
 
         public ClientTypeReference Type { get; }
         public string Name { get; }
+        public string? Description { get; }
         public ClientConstant? DefaultValue { get; }
         public bool IsRequired { get; }
     }

src/AutoRest.CSharp.V3/CodeGen/ClientWriter.cs

@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Linq;
 using System.Text.Json;
 using System.Threading;
@@ -33,6 +32,7 @@ namespace AutoRest.CSharp.V3.CodeGen
             var @namespace = cs.Namespace;
             using (writer.Namespace(@namespace))
             {
+                writer.WriteXmlDocumentationSummary(operationGroup.Description);
                 using (writer.Class("internal", "partial", cs.Name))
                 {
                     WriteClientFields(writer, operationGroup);
@@ -62,6 +62,7 @@ namespace AutoRest.CSharp.V3.CodeGen
 
         private void WriteClientCtor(CodeWriter writer, ServiceClient operationGroup, CSharpType cs)
         {
+            writer.WriteXmlDocumentationSummary($"Initializes a new instance of {cs.Name}");
             writer.Append($"public {cs.Name:D}({typeof(ClientDiagnostics)} clientDiagnostics, {typeof(HttpPipeline)} pipeline,");
             foreach (ServiceClientParameter clientParameter in operationGroup.Parameters)
             {
@@ -185,6 +186,15 @@ namespace AutoRest.CSharp.V3.CodeGen
             };
 
 
+            writer.WriteXmlDocumentationSummary(operation.Description);
+
+            foreach (ServiceClientParameter parameter in operation.Parameters)
+            {
+                writer.WriteXmlDocumentationParameter(parameter.Name, parameter.Description);
+            }
+
+            writer.WriteXmlDocumentationParameter("cancellationToken", "The cancellation token to use.");
+
             var methodName = operation.Name;
             if (async)
             {

src/AutoRest.CSharp.V3/CodeGen/CodeWriter.cs

@@ -177,9 +177,6 @@ namespace AutoRest.CSharp.V3.CodeGen
         public void MethodExpression(string modifiers, string? returnType, string name, string[]? parameters, string expression) =>
             LineRaw($"{MethodDeclaration(modifiers, returnType, name, parameters ?? new string[0])} => {expression};");
 
-        public void EnumValue(string value, bool includeComma = true) =>
-            LineRaw($"{value}{(includeComma ? "," : String.Empty)}");
-
         public void UseNamespace(CSharpNamespace @namespace)
         {
             _usingNamespaces.Add(@namespace);

src/AutoRest.CSharp.V3/CodeGen/DocumentationWriterExtensions.cs

@@ -0,0 +1,74 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using System;
+using System.Security;
+
+namespace AutoRest.CSharp.V3.CodeGen
+{
+    internal static class DocumentationWriterExtensions
+    {
+        private static readonly char[] _newLineChars = {'\r', '\n'};
+
+        public static CodeWriter WriteXmlDocumentationInheritDoc(this CodeWriter writer)
+        {
+            return writer.Line($"/// <inheritdoc />");
+        }
+
+        public static CodeWriter WriteXmlDocumentationSummary(this CodeWriter writer, string? text)
+        {
+            return writer.WriteXmlDocumentation("summary", text);
+        }
+
+        public static CodeWriter WriteXmlDocumentation(this CodeWriter writer, string tag, string? text)
+        {
+            return writer.WriteDocumentationLines($"<{tag}>", $"</{tag}>", text);
+        }
+
+        public static CodeWriter WriteXmlDocumentationParameter(this CodeWriter writer, string name, string? text)
+        {
+            return writer.WriteDocumentationLines($"<param name=\"{name}\">", "</param>", text);
+        }
+
+        private static CodeWriter WriteDocumentationLines(this CodeWriter writer, string prefix, string suffix, string? text)
+        {
+            if (string.IsNullOrEmpty(text))
+            {
+                return writer;
+            }
+
+            var splitLines = SplitDocLines(text);
+            if (splitLines.Length == 1)
+            {
+                writer.Line($"/// {prefix} {splitLines[0]} {suffix}");
+            }
+            else
+            {
+                writer.Line($"/// {prefix}");
+                foreach (string line in splitLines)
+                {
+                    writer.Line($"/// {line}");
+                }
+                writer.Line($"/// {suffix}");
+            }
+
+            return writer;
+        }
+
+        private static string[] SplitDocLines(string text)
+        {
+            var lines = text.Split(_newLineChars);
+            for (int i = 0; i < lines.Length; i++)
+            {
+                lines[i] = lines[i].TrimEnd();
+            }
+
+            if (lines.Length > 0 && !lines[^1].EndsWith("."))
+            {
+                lines[^1] = lines[^1] + ".";
+            }
+
+            return lines;
+        }
+    }
+}

src/AutoRest.CSharp.V3/CodeGen/ModelWriter.cs

@@ -56,11 +56,12 @@ namespace AutoRest.CSharp.V3.CodeGen
                     implementsTypes.Add(writer.Type(dictionaryType));
                 }
 
-
+                writer.WriteXmlDocumentationSummary(schema.Description);
                 using (writer.Class(null, "partial", schema.Name, implements: string.Join(", ", implementsTypes)))
                 {
                     if (schema.Discriminator != null)
                     {
+                        writer.WriteXmlDocumentationSummary($"Initializes a new instance of {cs.Name}");
                         using (writer.Method("public", null, cs.Name))
                         {
                             writer.Line($"{schema.Discriminator.Property} = {schema.Discriminator.Value:L};");
@@ -69,6 +70,8 @@ namespace AutoRest.CSharp.V3.CodeGen
 
                     foreach (var property in schema.Properties)
                     {
+                        writer.WriteXmlDocumentationSummary(property.Description);
+
                         CSharpType propertyType = _typeFactory.CreateType(property.Type);
                         writer.Append($"public {propertyType} {property.Name:D}");
                         writer.AppendRaw(property.IsReadOnly ? "{ get; internal set; }" : "{ get; set; }");
@@ -103,23 +106,41 @@ namespace AutoRest.CSharp.V3.CodeGen
                         string additionalProperties = "_additionalProperties";
                         writer.Line($"private readonly {implementationType} {additionalProperties} = new {fieldType}();");
 
-                        writer.Line($"public {iEnumeratorKeyValuePairType} GetEnumerator() => {additionalProperties}.GetEnumerator();")
+                        writer
+                            .WriteXmlDocumentationInheritDoc()
+                            .Line($"public {iEnumeratorKeyValuePairType} GetEnumerator() => {additionalProperties}.GetEnumerator();")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"{iEnumerator}  {iEnumerable}.GetEnumerator() => {additionalProperties}.GetEnumerator();")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"public {iCollectionKeyType} Keys => {additionalProperties}.Keys;")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"public {iCollectionItemType} Values => {additionalProperties}.Values;")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"public bool TryGetValue(string key, out {itemType} value) => {additionalProperties}.TryGetValue(key, out value);")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"public void Add({keyType} key, {itemType} value) => {additionalProperties}.Add(key, value);")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"public bool ContainsKey({keyType} key) => {additionalProperties}.ContainsKey(key);")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"public bool Remove({keyType} key) => {additionalProperties}.Remove(key);")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"public int Count => _additionalProperties.Count;")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"bool {iCollectionKeyValuePairType}.IsReadOnly => {additionalProperties}.IsReadOnly;")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"void {iCollectionKeyValuePairType}.Add({keyValuePairType} value) => {additionalProperties}.Add(value);")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"bool {iCollectionKeyValuePairType}.Remove({keyValuePairType} value) => {additionalProperties}.Remove(value);")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"bool {iCollectionKeyValuePairType}.Contains({keyValuePairType} value) => {additionalProperties}.Contains(value);")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"void {iCollectionKeyValuePairType}.CopyTo({keyValuePairType}[] destination, int offset) => {additionalProperties}.CopyTo(destination, offset);")
+                            .WriteXmlDocumentationInheritDoc()
                             .Line($"void {iCollectionKeyValuePairType}.Clear() => {additionalProperties}.Clear();");
 
-                        using (writer.Append($"public {itemType} this[{keyType} key]").Scope())
+                        using (writer
+                            .WriteXmlDocumentationInheritDoc()
+                            .Scope($"public {itemType} this[{keyType} key]"))
                         {
                             writer
                                 .Line($"get => _additionalProperties[key];")
@@ -156,9 +177,16 @@ namespace AutoRest.CSharp.V3.CodeGen
             var cs = _typeFactory.CreateType(schema);
             using (writer.Namespace(cs.Namespace))
             {
-                using (writer.Enum(null, null, cs.Name))
+                writer.WriteXmlDocumentationSummary(schema.Description);
+
+                using (writer.Scope($"public enum {cs.Name}"))
                 {
-                    schema.Values.Select(c => c).ForEachLast(ccs => writer.EnumValue(ccs.Name), ccs => writer.EnumValue(ccs.Name, false));
+                    foreach (ClientEnumValue value in schema.Values)
+                    {
+                        writer.WriteXmlDocumentationSummary(value.Description);
+                        writer.Line($"{value.Name},");
+                    }
+                    writer.RemoveTrailingComma();
                 }
             }
         }
@@ -168,6 +196,8 @@ namespace AutoRest.CSharp.V3.CodeGen
             var cs = _typeFactory.CreateType(schema);
             using (writer.Namespace(cs.Namespace))
             {
+                writer.WriteXmlDocumentationSummary(schema.Description);
+
                 var implementType = new CSharpType(typeof(IEquatable<>), cs);
                 using (writer.Struct(null, "readonly partial", schema.Name, writer.Type(implementType)))
                 {
@@ -178,6 +208,7 @@ namespace AutoRest.CSharp.V3.CodeGen
                     writer.LineRaw($"private readonly {writer.Pair(nullableStringText, "_value")};");
                     writer.Line();
 
+                    writer.WriteXmlDocumentationSummary($"Determines if two <see cref=\"{cs.Name}\"/> values are the same.");
                     using (writer.Method("public", null, schema.Name, writer.Pair(stringText, "value")))
                     {
                         writer.LineRaw($"_value = value ?? throw new {writer.Type(typeof(ArgumentNullException))}(nameof(value));");
@@ -192,24 +223,38 @@ namespace AutoRest.CSharp.V3.CodeGen
 
                     foreach (var choice in schema.Values)
                     {
+                        writer.WriteXmlDocumentationSummary(choice.Description);
                         writer.LineRaw($"public static {writer.Pair(csTypeText, choice.Name)} {{ get; }} = new {csTypeText}({choice.Name}Value);");
                     }
 
                     var boolText = writer.Type(typeof(bool));
                     var leftRightParams = new[] { writer.Pair(csTypeText, "left"), writer.Pair(csTypeText, "right")};
+
+                    writer.WriteXmlDocumentationSummary($"Determines if two <see cref=\"{cs.Name}\"/> values are the same.");
                     writer.MethodExpression("public static", boolText, "operator ==", leftRightParams, "left.Equals(right)");
+
+                    writer.WriteXmlDocumentationSummary($"Determines if two <see cref=\"{cs.Name}\"/> values are not the same.");
                     writer.MethodExpression("public static", boolText, "operator !=", leftRightParams, "!left.Equals(right)");
+
+                    writer.WriteXmlDocumentationSummary($"Converts a string to a <see cref=\"{cs.Name}\"/>.");
                     writer.MethodExpression("public static implicit", null, $"operator {csTypeText}", new[]{ writer.Pair(stringText, "value")}, $"new {csTypeText}(value)");
                     writer.Line();
 
                     var editorBrowsableNever = $"[{writer.AttributeType(typeof(EditorBrowsableAttribute))}({writer.Type(typeof(EditorBrowsableState))}.Never)]";
+
+                    writer.WriteXmlDocumentationInheritDoc();
                     writer.LineRaw(editorBrowsableNever);
                     writer.MethodExpression("public override", boolText, "Equals", new[]{ writer.Pair(typeof(object), "obj", true)}, $"obj is {csTypeText} other && Equals(other)");
+
+                    writer.WriteXmlDocumentationInheritDoc();
                     writer.MethodExpression("public", boolText, "Equals", new[] { writer.Pair(csTypeText, "other") }, $"{stringText}.Equals(_value, other._value, {writer.Type(typeof(StringComparison))}.Ordinal)");
                     writer.Line();
 
+                    writer.WriteXmlDocumentationInheritDoc();
                     writer.LineRaw(editorBrowsableNever);
                     writer.MethodExpression("public override", writer.Type(typeof(int)), "GetHashCode", null, "_value?.GetHashCode() ?? 0");
+
+                    writer.WriteXmlDocumentationInheritDoc();
                     writer.MethodExpression("public override", nullableStringText, "ToString", null, "_value");
                 }
             }

test/TestServerProjects/Directory.Build.props

@@ -4,6 +4,7 @@
   </ItemGroup>
   <PropertyGroup>
     <IncludeStyleCopAnalyzers>false</IncludeStyleCopAnalyzers>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
   <Import Project="..\..\Directory.Build.props" />
 </Project>

test/TestServerProjects/additionalProperties/Generated/Models/CatAPTrue.cs

@@ -3,8 +3,10 @@
 
 namespace additionalProperties.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class CatAPTrue : PetAPTrue
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? Friendly { get; set; }
     }
 }

test/TestServerProjects/additionalProperties/Generated/Models/Error.cs

@@ -3,9 +3,12 @@
 
 namespace additionalProperties.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Error
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Status { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Message { get; set; }
     }
 }

test/TestServerProjects/additionalProperties/Generated/Models/PetAPInProperties.cs

@@ -5,11 +5,16 @@ using System.Collections.Generic;
 
 namespace additionalProperties.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class PetAPInProperties
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int Id { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Name { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? Status { get; internal set; }
+        /// <summary> Dictionary of &lt;components·schemas·petapinproperties·properties·additionalproperties·additionalproperties&gt;. </summary>
         public IDictionary<string, float>? AdditionalProperties { get; set; }
     }
 }

test/TestServerProjects/additionalProperties/Generated/Models/PetAPInPropertiesWithAPString.cs

@@ -6,29 +6,51 @@ using System.Collections.Generic;
 
 namespace additionalProperties.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class PetAPInPropertiesWithAPString : IDictionary<string, string>
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int Id { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Name { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? Status { get; internal set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string OdataLocation { get; set; }
+        /// <summary> Dictionary of &lt;components·schemas·petapinproperties·properties·additionalproperties·additionalproperties&gt;. </summary>
         public IDictionary<string, float>? AdditionalProperties { get; set; }
         private readonly IDictionary<string, string> _additionalProperties = new Dictionary<string, string>();
+        /// <inheritdoc />
         public IEnumerator<KeyValuePair<string, string>> GetEnumerator() => _additionalProperties.GetEnumerator();
+        /// <inheritdoc />
         IEnumerator IEnumerable.GetEnumerator() => _additionalProperties.GetEnumerator();
+        /// <inheritdoc />
         public ICollection<string> Keys => _additionalProperties.Keys;
+        /// <inheritdoc />
         public ICollection<string> Values => _additionalProperties.Values;
+        /// <inheritdoc />
         public bool TryGetValue(string key, out string value) => _additionalProperties.TryGetValue(key, out value);
+        /// <inheritdoc />
         public void Add(string key, string value) => _additionalProperties.Add(key, value);
+        /// <inheritdoc />
         public bool ContainsKey(string key) => _additionalProperties.ContainsKey(key);
+        /// <inheritdoc />
         public bool Remove(string key) => _additionalProperties.Remove(key);
+        /// <inheritdoc />
         public int Count => _additionalProperties.Count;
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, string>>.IsReadOnly => _additionalProperties.IsReadOnly;
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, string>>.Add(KeyValuePair<string, string> value) => _additionalProperties.Add(value);
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, string>>.Remove(KeyValuePair<string, string> value) => _additionalProperties.Remove(value);
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, string>>.Contains(KeyValuePair<string, string> value) => _additionalProperties.Contains(value);
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, string>>.CopyTo(KeyValuePair<string, string>[] destination, int offset) => _additionalProperties.CopyTo(destination, offset);
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, string>>.Clear() => _additionalProperties.Clear();
+        /// <inheritdoc />
         public string this[string key]
         {
             get => _additionalProperties[key];

test/TestServerProjects/additionalProperties/Generated/Models/PetAPObject.cs

@@ -6,27 +6,47 @@ using System.Collections.Generic;
 
 namespace additionalProperties.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class PetAPObject : IDictionary<string, object>
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int Id { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Name { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? Status { get; internal set; }
         private readonly IDictionary<string, object> _additionalProperties = new Dictionary<string, object>();
+        /// <inheritdoc />
         public IEnumerator<KeyValuePair<string, object>> GetEnumerator() => _additionalProperties.GetEnumerator();
+        /// <inheritdoc />
         IEnumerator IEnumerable.GetEnumerator() => _additionalProperties.GetEnumerator();
+        /// <inheritdoc />
         public ICollection<string> Keys => _additionalProperties.Keys;
+        /// <inheritdoc />
         public ICollection<object> Values => _additionalProperties.Values;
+        /// <inheritdoc />
         public bool TryGetValue(string key, out object value) => _additionalProperties.TryGetValue(key, out value);
+        /// <inheritdoc />
         public void Add(string key, object value) => _additionalProperties.Add(key, value);
+        /// <inheritdoc />
         public bool ContainsKey(string key) => _additionalProperties.ContainsKey(key);
+        /// <inheritdoc />
         public bool Remove(string key) => _additionalProperties.Remove(key);
+        /// <inheritdoc />
         public int Count => _additionalProperties.Count;
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, object>>.IsReadOnly => _additionalProperties.IsReadOnly;
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, object>>.Add(KeyValuePair<string, object> value) => _additionalProperties.Add(value);
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, object>>.Remove(KeyValuePair<string, object> value) => _additionalProperties.Remove(value);
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, object>>.Contains(KeyValuePair<string, object> value) => _additionalProperties.Contains(value);
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, object>>.CopyTo(KeyValuePair<string, object>[] destination, int offset) => _additionalProperties.CopyTo(destination, offset);
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, object>>.Clear() => _additionalProperties.Clear();
+        /// <inheritdoc />
         public object this[string key]
         {
             get => _additionalProperties[key];

test/TestServerProjects/additionalProperties/Generated/Models/PetAPString.cs

@@ -6,27 +6,47 @@ using System.Collections.Generic;
 
 namespace additionalProperties.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class PetAPString : IDictionary<string, string>
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int Id { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Name { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? Status { get; internal set; }
         private readonly IDictionary<string, string> _additionalProperties = new Dictionary<string, string>();
+        /// <inheritdoc />
         public IEnumerator<KeyValuePair<string, string>> GetEnumerator() => _additionalProperties.GetEnumerator();
+        /// <inheritdoc />
         IEnumerator IEnumerable.GetEnumerator() => _additionalProperties.GetEnumerator();
+        /// <inheritdoc />
         public ICollection<string> Keys => _additionalProperties.Keys;
+        /// <inheritdoc />
         public ICollection<string> Values => _additionalProperties.Values;
+        /// <inheritdoc />
         public bool TryGetValue(string key, out string value) => _additionalProperties.TryGetValue(key, out value);
+        /// <inheritdoc />
         public void Add(string key, string value) => _additionalProperties.Add(key, value);
+        /// <inheritdoc />
         public bool ContainsKey(string key) => _additionalProperties.ContainsKey(key);
+        /// <inheritdoc />
         public bool Remove(string key) => _additionalProperties.Remove(key);
+        /// <inheritdoc />
         public int Count => _additionalProperties.Count;
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, string>>.IsReadOnly => _additionalProperties.IsReadOnly;
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, string>>.Add(KeyValuePair<string, string> value) => _additionalProperties.Add(value);
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, string>>.Remove(KeyValuePair<string, string> value) => _additionalProperties.Remove(value);
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, string>>.Contains(KeyValuePair<string, string> value) => _additionalProperties.Contains(value);
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, string>>.CopyTo(KeyValuePair<string, string>[] destination, int offset) => _additionalProperties.CopyTo(destination, offset);
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, string>>.Clear() => _additionalProperties.Clear();
+        /// <inheritdoc />
         public string this[string key]
         {
             get => _additionalProperties[key];

test/TestServerProjects/additionalProperties/Generated/Models/PetAPTrue.cs

@@ -6,27 +6,47 @@ using System.Collections.Generic;
 
 namespace additionalProperties.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class PetAPTrue : IDictionary<string, object>
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int Id { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Name { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? Status { get; internal set; }
         private readonly IDictionary<string, object> _additionalProperties = new Dictionary<string, object>();
+        /// <inheritdoc />
         public IEnumerator<KeyValuePair<string, object>> GetEnumerator() => _additionalProperties.GetEnumerator();
+        /// <inheritdoc />
         IEnumerator IEnumerable.GetEnumerator() => _additionalProperties.GetEnumerator();
+        /// <inheritdoc />
         public ICollection<string> Keys => _additionalProperties.Keys;
+        /// <inheritdoc />
         public ICollection<object> Values => _additionalProperties.Values;
+        /// <inheritdoc />
         public bool TryGetValue(string key, out object value) => _additionalProperties.TryGetValue(key, out value);
+        /// <inheritdoc />
         public void Add(string key, object value) => _additionalProperties.Add(key, value);
+        /// <inheritdoc />
         public bool ContainsKey(string key) => _additionalProperties.ContainsKey(key);
+        /// <inheritdoc />
         public bool Remove(string key) => _additionalProperties.Remove(key);
+        /// <inheritdoc />
         public int Count => _additionalProperties.Count;
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, object>>.IsReadOnly => _additionalProperties.IsReadOnly;
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, object>>.Add(KeyValuePair<string, object> value) => _additionalProperties.Add(value);
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, object>>.Remove(KeyValuePair<string, object> value) => _additionalProperties.Remove(value);
+        /// <inheritdoc />
         bool ICollection<KeyValuePair<string, object>>.Contains(KeyValuePair<string, object> value) => _additionalProperties.Contains(value);
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, object>>.CopyTo(KeyValuePair<string, object>[] destination, int offset) => _additionalProperties.CopyTo(destination, offset);
+        /// <inheritdoc />
         void ICollection<KeyValuePair<string, object>>.Clear() => _additionalProperties.Clear();
+        /// <inheritdoc />
         public object this[string key]
         {
             get => _additionalProperties[key];

test/TestServerProjects/additionalProperties/Generated/Operations/PetsOperations.cs

@@ -17,6 +17,7 @@ namespace additionalProperties
         private string host;
         private ClientDiagnostics clientDiagnostics;
         private HttpPipeline pipeline;
+        /// <summary> Initializes a new instance of PetsOperations. </summary>
         public PetsOperations(ClientDiagnostics clientDiagnostics, HttpPipeline pipeline, string host = "http://localhost:3000")
         {
             if (host == null)
@@ -41,6 +42,9 @@ namespace additionalProperties
             request.Content = content;
             return message;
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPTrue to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<PetAPTrue>> CreateAPTrueAsync(PetAPTrue createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -72,6 +76,9 @@ namespace additionalProperties
                 throw;
             }
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPTrue to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<PetAPTrue> CreateAPTrue(PetAPTrue createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -116,6 +123,9 @@ namespace additionalProperties
             request.Content = content;
             return message;
         }
+        /// <summary> Create a CatAPTrue which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The CatAPTrue to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<CatAPTrue>> CreateCatAPTrueAsync(CatAPTrue createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -147,6 +157,9 @@ namespace additionalProperties
                 throw;
             }
         }
+        /// <summary> Create a CatAPTrue which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The CatAPTrue to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<CatAPTrue> CreateCatAPTrue(CatAPTrue createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -191,6 +204,9 @@ namespace additionalProperties
             request.Content = content;
             return message;
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPObject to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<PetAPObject>> CreateAPObjectAsync(PetAPObject createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -222,6 +238,9 @@ namespace additionalProperties
                 throw;
             }
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPObject to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<PetAPObject> CreateAPObject(PetAPObject createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -266,6 +285,9 @@ namespace additionalProperties
             request.Content = content;
             return message;
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPString to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<PetAPString>> CreateAPStringAsync(PetAPString createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -297,6 +319,9 @@ namespace additionalProperties
                 throw;
             }
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPString to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<PetAPString> CreateAPString(PetAPString createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -341,6 +366,9 @@ namespace additionalProperties
             request.Content = content;
             return message;
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPInProperties to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<PetAPInProperties>> CreateAPInPropertiesAsync(PetAPInProperties createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -372,6 +400,9 @@ namespace additionalProperties
                 throw;
             }
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPInProperties to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<PetAPInProperties> CreateAPInProperties(PetAPInProperties createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -416,6 +447,9 @@ namespace additionalProperties
             request.Content = content;
             return message;
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPInPropertiesWithAPString to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<PetAPInPropertiesWithAPString>> CreateAPInPropertiesWithAPStringAsync(PetAPInPropertiesWithAPString createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)
@@ -447,6 +481,9 @@ namespace additionalProperties
                 throw;
             }
         }
+        /// <summary> Create a Pet which contains more properties than what is defined. </summary>
+        /// <param name="createParameters"> The PetAPInPropertiesWithAPString to use. </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<PetAPInPropertiesWithAPString> CreateAPInPropertiesWithAPString(PetAPInPropertiesWithAPString createParameters, CancellationToken cancellationToken = default)
         {
             if (createParameters == null)

test/TestServerProjects/body-array/Generated/Models/Enum0.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace body_array.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
     public readonly partial struct Enum0 : IEquatable<Enum0>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="Enum0"/> values are the same. </summary>
         public Enum0(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -19,19 +21,29 @@ namespace body_array.Models.V100
         private const string Foo2Value = "foo2";
         private const string Foo3Value = "foo3";
 
+        /// <summary> foo1. </summary>
         public static Enum0 Foo1 { get; } = new Enum0(Foo1Value);
+        /// <summary> foo2. </summary>
         public static Enum0 Foo2 { get; } = new Enum0(Foo2Value);
+        /// <summary> foo3. </summary>
         public static Enum0 Foo3 { get; } = new Enum0(Foo3Value);
+        /// <summary> Determines if two <see cref="Enum0"/> values are the same. </summary>
         public static bool operator ==(Enum0 left, Enum0 right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="Enum0"/> values are not the same. </summary>
         public static bool operator !=(Enum0 left, Enum0 right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="Enum0"/>. </summary>
         public static implicit operator Enum0(string value) => new Enum0(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is Enum0 other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(Enum0 other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

test/TestServerProjects/body-array/Generated/Models/Error.cs

@@ -3,9 +3,12 @@
 
 namespace body_array.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Error
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Status { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Message { get; set; }
     }
 }

test/TestServerProjects/body-array/Generated/Models/FooEnum.cs

@@ -3,10 +3,14 @@
 
 namespace body_array.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
     public enum FooEnum
     {
+        /// <summary> foo1. </summary>
         Foo1,
+        /// <summary> foo2. </summary>
         Foo2,
+        /// <summary> foo3. </summary>
         Foo3
     }
 }

test/TestServerProjects/body-array/Generated/Models/Product.cs

@@ -3,9 +3,12 @@
 
 namespace body_array.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Product
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Integer { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? String { get; set; }
     }
 }

test/TestServerProjects/body-boolean/Generated/Models/Error.cs

@@ -3,9 +3,12 @@
 
 namespace body_boolean.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Error
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Status { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Message { get; set; }
     }
 }

test/TestServerProjects/body-boolean/Generated/Operations/BoolOperations.cs

@@ -16,6 +16,7 @@ namespace body_boolean
         private string host;
         private ClientDiagnostics clientDiagnostics;
         private HttpPipeline pipeline;
+        /// <summary> Initializes a new instance of BoolOperations. </summary>
         public BoolOperations(ClientDiagnostics clientDiagnostics, HttpPipeline pipeline, string host = "http://localhost:3000")
         {
             if (host == null)
@@ -36,6 +37,8 @@ namespace body_boolean
             request.Uri.AppendPath("/bool/true", false);
             return message;
         }
+        /// <summary> Get true Boolean value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<bool>> GetTrueAsync(CancellationToken cancellationToken = default)
         {
 
@@ -63,6 +66,8 @@ namespace body_boolean
                 throw;
             }
         }
+        /// <summary> Get true Boolean value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<bool> GetTrue(CancellationToken cancellationToken = default)
         {
 
@@ -103,6 +108,8 @@ namespace body_boolean
             request.Content = content;
             return message;
         }
+        /// <summary> Set Boolean value true. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response> PutTrueAsync(CancellationToken cancellationToken = default)
         {
 
@@ -126,6 +133,8 @@ namespace body_boolean
                 throw;
             }
         }
+        /// <summary> Set Boolean value true. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response PutTrue(CancellationToken cancellationToken = default)
         {
 
@@ -158,6 +167,8 @@ namespace body_boolean
             request.Uri.AppendPath("/bool/false", false);
             return message;
         }
+        /// <summary> Get false Boolean value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<bool>> GetFalseAsync(CancellationToken cancellationToken = default)
         {
 
@@ -185,6 +196,8 @@ namespace body_boolean
                 throw;
             }
         }
+        /// <summary> Get false Boolean value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<bool> GetFalse(CancellationToken cancellationToken = default)
         {
 
@@ -225,6 +238,8 @@ namespace body_boolean
             request.Content = content;
             return message;
         }
+        /// <summary> Set Boolean value false. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response> PutFalseAsync(CancellationToken cancellationToken = default)
         {
 
@@ -248,6 +263,8 @@ namespace body_boolean
                 throw;
             }
         }
+        /// <summary> Set Boolean value false. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response PutFalse(CancellationToken cancellationToken = default)
         {
 
@@ -280,6 +297,8 @@ namespace body_boolean
             request.Uri.AppendPath("/bool/null", false);
             return message;
         }
+        /// <summary> Get null Boolean value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<bool>> GetNullAsync(CancellationToken cancellationToken = default)
         {
 
@@ -307,6 +326,8 @@ namespace body_boolean
                 throw;
             }
         }
+        /// <summary> Get null Boolean value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<bool> GetNull(CancellationToken cancellationToken = default)
         {
 
@@ -343,6 +364,8 @@ namespace body_boolean
             request.Uri.AppendPath("/bool/invalid", false);
             return message;
         }
+        /// <summary> Get invalid Boolean value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<bool>> GetInvalidAsync(CancellationToken cancellationToken = default)
         {
 
@@ -370,6 +393,8 @@ namespace body_boolean
                 throw;
             }
         }
+        /// <summary> Get invalid Boolean value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<bool> GetInvalid(CancellationToken cancellationToken = default)
         {
 

test/TestServerProjects/body-byte/Generated/Models/Error.cs

@@ -3,9 +3,12 @@
 
 namespace body_byte.Models.V100
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Error
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Status { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Message { get; set; }
     }
 }

test/TestServerProjects/body-byte/Generated/Operations/ByteOperations.cs

@@ -16,6 +16,7 @@ namespace body_byte
         private string host;
         private ClientDiagnostics clientDiagnostics;
         private HttpPipeline pipeline;
+        /// <summary> Initializes a new instance of ByteOperations. </summary>
         public ByteOperations(ClientDiagnostics clientDiagnostics, HttpPipeline pipeline, string host = "http://localhost:3000")
         {
             if (host == null)
@@ -36,6 +37,8 @@ namespace body_byte
             request.Uri.AppendPath("/byte/null", false);
             return message;
         }
+        /// <summary> Get null byte value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<byte[]>> GetNullAsync(CancellationToken cancellationToken = default)
         {
 
@@ -63,6 +66,8 @@ namespace body_byte
                 throw;
             }
         }
+        /// <summary> Get null byte value. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<byte[]> GetNull(CancellationToken cancellationToken = default)
         {
 
@@ -99,6 +104,8 @@ namespace body_byte
             request.Uri.AppendPath("/byte/empty", false);
             return message;
         }
+        /// <summary> Get empty byte value &apos;&apos;. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<byte[]>> GetEmptyAsync(CancellationToken cancellationToken = default)
         {
 
@@ -126,6 +133,8 @@ namespace body_byte
                 throw;
             }
         }
+        /// <summary> Get empty byte value &apos;&apos;. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<byte[]> GetEmpty(CancellationToken cancellationToken = default)
         {
 
@@ -162,6 +171,8 @@ namespace body_byte
             request.Uri.AppendPath("/byte/nonAscii", false);
             return message;
         }
+        /// <summary> Get non-ascii byte string hex(FF FE FD FC FB FA F9 F8 F7 F6). </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<byte[]>> GetNonAsciiAsync(CancellationToken cancellationToken = default)
         {
 
@@ -189,6 +200,8 @@ namespace body_byte
                 throw;
             }
         }
+        /// <summary> Get non-ascii byte string hex(FF FE FD FC FB FA F9 F8 F7 F6). </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<byte[]> GetNonAscii(CancellationToken cancellationToken = default)
         {
 
@@ -229,6 +242,9 @@ namespace body_byte
             request.Content = content;
             return message;
         }
+        /// <summary> Put non-ascii byte string hex(FF FE FD FC FB FA F9 F8 F7 F6). </summary>
+        /// <param name="byteBody"> Base64-encoded non-ascii byte string hex(FF FE FD FC FB FA F9 F8 F7 F6). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response> PutNonAsciiAsync(byte[] byteBody, CancellationToken cancellationToken = default)
         {
             if (byteBody == null)
@@ -256,6 +272,9 @@ namespace body_byte
                 throw;
             }
         }
+        /// <summary> Put non-ascii byte string hex(FF FE FD FC FB FA F9 F8 F7 F6). </summary>
+        /// <param name="byteBody"> Base64-encoded non-ascii byte string hex(FF FE FD FC FB FA F9 F8 F7 F6). </param>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response PutNonAscii(byte[] byteBody, CancellationToken cancellationToken = default)
         {
             if (byteBody == null)
@@ -292,6 +311,8 @@ namespace body_byte
             request.Uri.AppendPath("/byte/invalid", false);
             return message;
         }
+        /// <summary> Get invalid byte value &apos;:::SWAGGER::::&apos;. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public async ValueTask<Response<byte[]>> GetInvalidAsync(CancellationToken cancellationToken = default)
         {
 
@@ -319,6 +340,8 @@ namespace body_byte
                 throw;
             }
         }
+        /// <summary> Get invalid byte value &apos;:::SWAGGER::::&apos;. </summary>
+        /// <param name="cancellationToken"> The cancellation token to use. </param>
         public Response<byte[]> GetInvalid(CancellationToken cancellationToken = default)
         {
 

test/TestServerProjects/body-complex/Generated/Models/ArrayWrapper.cs

@@ -5,8 +5,10 @@ using System.Collections.Generic;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class ArrayWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-ARRAYSCHEMA. </summary>
         public ICollection<string>? Array { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/Basic.cs

@@ -3,10 +3,14 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Basic
     {
+        /// <summary> Basic Id. </summary>
         public int? Id { get; set; }
+        /// <summary> Name property with a very long description that does not fit on a single line and a line break. </summary>
         public string? Name { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
         public CMYKColors? Color { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/BooleanWrapper.cs

@@ -3,9 +3,12 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class BooleanWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? FieldTrue { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? FieldFalse { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/ByteWrapper.cs

@@ -5,8 +5,10 @@ using System;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class ByteWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BYTEARRAY. </summary>
         public byte[]? Field { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/CMYKColors.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-CHOICE. </summary>
     public readonly partial struct CMYKColors : IEquatable<CMYKColors>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="CMYKColors"/> values are the same. </summary>
         public CMYKColors(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -20,20 +22,31 @@ namespace body_complex.Models.V20160229
         private const string YELLOWValue = "YELLOW";
         private const string BlacKValue = "blacK";
 
+        /// <summary> cyan. </summary>
         public static CMYKColors Cyan { get; } = new CMYKColors(CyanValue);
+        /// <summary> Magenta. </summary>
         public static CMYKColors Magenta { get; } = new CMYKColors(MagentaValue);
+        /// <summary> YELLOW. </summary>
         public static CMYKColors YELLOW { get; } = new CMYKColors(YELLOWValue);
+        /// <summary> blacK. </summary>
         public static CMYKColors BlacK { get; } = new CMYKColors(BlacKValue);
+        /// <summary> Determines if two <see cref="CMYKColors"/> values are the same. </summary>
         public static bool operator ==(CMYKColors left, CMYKColors right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="CMYKColors"/> values are not the same. </summary>
         public static bool operator !=(CMYKColors left, CMYKColors right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="CMYKColors"/>. </summary>
         public static implicit operator CMYKColors(string value) => new CMYKColors(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is CMYKColors other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(CMYKColors other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

test/TestServerProjects/body-complex/Generated/Models/Cat.cs

@@ -5,9 +5,12 @@ using System.Collections.Generic;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Cat : Pet
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Color { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-ARRAYSCHEMA. </summary>
         public ICollection<Dog>? Hates { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/Cookiecuttershark.cs

@@ -3,8 +3,10 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Cookiecuttershark : Shark
     {
+        /// <summary> Initializes a new instance of Cookiecuttershark. </summary>
         public Cookiecuttershark()
         {
             Fishtype = "cookiecuttershark";

test/TestServerProjects/body-complex/Generated/Models/DateWrapper.cs

@@ -5,9 +5,12 @@ using System;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DateWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-DATE. </summary>
         public DateTimeOffset? Field { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-DATE. </summary>
         public DateTimeOffset? Leap { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/DatetimeWrapper.cs

@@ -5,9 +5,12 @@ using System;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DatetimeWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-DATETIME. </summary>
         public DateTimeOffset? Field { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-DATETIME. </summary>
         public DateTimeOffset? Now { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/Datetimerfc1123Wrapper.cs

@@ -5,9 +5,12 @@ using System;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Datetimerfc1123Wrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-DATETIME. </summary>
         public DateTimeOffset? Field { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-DATETIME. </summary>
         public DateTimeOffset? Now { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/DictionaryWrapper.cs

@@ -5,8 +5,10 @@ using System.Collections.Generic;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DictionaryWrapper
     {
+        /// <summary> Dictionary of &lt;components·schemas·dictionary_wrapper·properties·defaultprogram·additionalproperties&gt;. </summary>
         public IDictionary<string, string>? DefaultProgram { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/Dog.cs

@@ -3,8 +3,10 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Dog : Pet
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Food { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/DotFish.cs

@@ -3,13 +3,17 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DotFish
     {
+        /// <summary> Initializes a new instance of DotFish. </summary>
         public DotFish()
         {
             FishType = null;
         }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string FishType { get; internal set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Species { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/DotFishMarket.cs

@@ -5,11 +5,16 @@ using System.Collections.Generic;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DotFishMarket
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
         public DotSalmon? SampleSalmon { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-ARRAYSCHEMA. </summary>
         public ICollection<DotSalmon>? Salmons { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
         public DotFish? SampleFish { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-ARRAYSCHEMA. </summary>
         public ICollection<DotFish>? Fishes { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/DotSalmon.cs

@@ -3,13 +3,17 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DotSalmon : DotFish
     {
+        /// <summary> Initializes a new instance of DotSalmon. </summary>
         public DotSalmon()
         {
             FishType = "DotSalmon";
         }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Location { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-BOOLEAN. </summary>
         public bool? Iswild { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/DoubleWrapper.cs

@@ -3,9 +3,12 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DoubleWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-NUMBER. </summary>
         public double? Field1 { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-NUMBER. </summary>
         public double? Field56ZerosAfterTheDotAndNegativeZeroBeforeDotAndThisIsALongFieldNameOnPurpose { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/DurationWrapper.cs

@@ -5,8 +5,10 @@ using System;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class DurationWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-DURATION. </summary>
         public TimeSpan? Field { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/Error.cs

@@ -3,9 +3,12 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Error
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Status { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Message { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/Fish.cs

@@ -5,15 +5,21 @@ using System.Collections.Generic;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Fish
     {
+        /// <summary> Initializes a new instance of Fish. </summary>
         public Fish()
         {
             Fishtype = null;
         }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string Fishtype { get; internal set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-STRING. </summary>
         public string? Species { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-NUMBER. </summary>
         public float Length { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-ARRAYSCHEMA. </summary>
         public ICollection<Fish>? Siblings { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/FloatWrapper.cs

@@ -3,9 +3,12 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class FloatWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-NUMBER. </summary>
         public float? Field1 { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-NUMBER. </summary>
         public float? Field2 { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/GoblinSharkColor.cs

@@ -6,10 +6,12 @@ using System.ComponentModel;
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> Colors possible. </summary>
     public readonly partial struct GoblinSharkColor : IEquatable<GoblinSharkColor>
     {
         private readonly string? _value;
 
+        /// <summary> Determines if two <see cref="GoblinSharkColor"/> values are the same. </summary>
         public GoblinSharkColor(string value)
         {
             _value = value ?? throw new ArgumentNullException(nameof(value));
@@ -19,19 +21,29 @@ namespace body_complex.Models.V20160229
         private const string GrayValue = "gray";
         private const string BrownValue = "brown";
 
+        /// <summary> pink. </summary>
         public static GoblinSharkColor Pink { get; } = new GoblinSharkColor(PinkValue);
+        /// <summary> gray. </summary>
         public static GoblinSharkColor Gray { get; } = new GoblinSharkColor(GrayValue);
+        /// <summary> brown. </summary>
         public static GoblinSharkColor Brown { get; } = new GoblinSharkColor(BrownValue);
+        /// <summary> Determines if two <see cref="GoblinSharkColor"/> values are the same. </summary>
         public static bool operator ==(GoblinSharkColor left, GoblinSharkColor right) => left.Equals(right);
+        /// <summary> Determines if two <see cref="GoblinSharkColor"/> values are not the same. </summary>
         public static bool operator !=(GoblinSharkColor left, GoblinSharkColor right) => !left.Equals(right);
+        /// <summary> Converts a string to a <see cref="GoblinSharkColor"/>. </summary>
         public static implicit operator GoblinSharkColor(string value) => new GoblinSharkColor(value);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override bool Equals(object? obj) => obj is GoblinSharkColor other && Equals(other);
+        /// <inheritdoc />
         public bool Equals(GoblinSharkColor other) => string.Equals(_value, other._value, StringComparison.Ordinal);
 
+        /// <inheritdoc />
         [EditorBrowsable(EditorBrowsableState.Never)]
         public override int GetHashCode() => _value?.GetHashCode() ?? 0;
+        /// <inheritdoc />
         public override string? ToString() => _value;
     }
 }

test/TestServerProjects/body-complex/Generated/Models/Goblinshark.cs

@@ -3,13 +3,17 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class Goblinshark : Shark
     {
+        /// <summary> Initializes a new instance of Goblinshark. </summary>
         public Goblinshark()
         {
             Fishtype = "goblin";
         }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Jawsize { get; set; }
+        /// <summary> Colors possible. </summary>
         public GoblinSharkColor? Color { get; set; }
     }
 }

test/TestServerProjects/body-complex/Generated/Models/IntWrapper.cs

@@ -3,9 +3,12 @@
 
 namespace body_complex.Models.V20160229
 {
+    /// <summary> MISSING·SCHEMA-DESCRIPTION-OBJECTSCHEMA. </summary>
     public partial class IntWrapper
     {
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Field1 { get; set; }
+        /// <summary> MISSING·SCHEMA-DESCRIPTION-INTEGER. </summary>
         public int? Field2 { get; set; }
     }
 }