diff --git a/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Abstractions/IServiceEndpointBuilder.cs b/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Abstractions/IServiceEndpointBuilder.cs index e051b2bf746..0165aba3851 100644 --- a/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Abstractions/IServiceEndpointBuilder.cs +++ b/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Abstractions/IServiceEndpointBuilder.cs @@ -7,7 +7,7 @@ namespace Microsoft.Extensions.ServiceDiscovery; /// -/// Builder to create a instances. +/// Represents a builder that creates instances. /// public interface IServiceEndpointBuilder { diff --git a/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Dns/DnsServiceEndpointProviderOptions.cs b/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Dns/DnsServiceEndpointProviderOptions.cs index b163afc76ff..4786dc97988 100644 --- a/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Dns/DnsServiceEndpointProviderOptions.cs +++ b/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Dns/DnsServiceEndpointProviderOptions.cs @@ -29,7 +29,10 @@ public class DnsServiceEndpointProviderOptions public double RetryBackOffFactor { get; set; } = 2; /// - /// Gets or sets a delegate used to determine whether to apply host name metadata to each resolved endpoint. Defaults to false. + /// Gets or sets a delegate used to determine whether to apply host name metadata to each resolved endpoint. /// + /// + /// The default delegate returns . + /// public Func ShouldApplyHostNameMetadata { get; set; } = _ => false; } diff --git a/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Dns/DnsSrvServiceEndpointProviderOptions.cs b/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Dns/DnsSrvServiceEndpointProviderOptions.cs index c1d64136cc9..3cfee893d77 100644 --- a/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Dns/DnsSrvServiceEndpointProviderOptions.cs +++ b/src/Libraries/Microsoft.Extensions.ServiceDiscovery.Dns/DnsSrvServiceEndpointProviderOptions.cs @@ -42,7 +42,10 @@ public class DnsSrvServiceEndpointProviderOptions public Func? ServiceDomainNameCallback { get; set; } /// - /// Gets or sets a delegate used to determine whether to apply host name metadata to each resolved endpoint. Defaults to false. + /// Gets or sets a delegate used to determine whether to apply host name metadata to each resolved endpoint. /// + /// + /// The default delegate returns . + /// public Func ShouldApplyHostNameMetadata { get; set; } = _ => false; } diff --git a/src/Libraries/Microsoft.Extensions.ServiceDiscovery/ConfigurationServiceEndpointProviderOptions.cs b/src/Libraries/Microsoft.Extensions.ServiceDiscovery/ConfigurationServiceEndpointProviderOptions.cs index 29f28e359f7..65176cf5c49 100644 --- a/src/Libraries/Microsoft.Extensions.ServiceDiscovery/ConfigurationServiceEndpointProviderOptions.cs +++ b/src/Libraries/Microsoft.Extensions.ServiceDiscovery/ConfigurationServiceEndpointProviderOptions.cs @@ -11,12 +11,18 @@ namespace Microsoft.Extensions.ServiceDiscovery; public sealed class ConfigurationServiceEndpointProviderOptions { /// - /// The name of the configuration section which contains service endpoints. Defaults to "Services". + /// Gets or sets the name of the configuration section that contains service endpoints. /// + /// + /// The default value is "Services". + /// public string SectionName { get; set; } = "Services"; /// - /// Gets or sets a delegate used to determine whether to apply host name metadata to each resolved endpoint. Defaults to a delegate which returns false. + /// Gets or sets a delegate used to determine whether to apply host name metadata to each resolved endpoint. /// + /// + /// The default delegate returns . + /// public Func ShouldApplyHostNameMetadata { get; set; } = _ => false; } diff --git a/src/Libraries/Microsoft.Extensions.ServiceDiscovery/Http/IServiceDiscoveryHttpMessageHandlerFactory.cs b/src/Libraries/Microsoft.Extensions.ServiceDiscovery/Http/IServiceDiscoveryHttpMessageHandlerFactory.cs index 0c5bd02d10d..f3fba8cafc6 100644 --- a/src/Libraries/Microsoft.Extensions.ServiceDiscovery/Http/IServiceDiscoveryHttpMessageHandlerFactory.cs +++ b/src/Libraries/Microsoft.Extensions.ServiceDiscovery/Http/IServiceDiscoveryHttpMessageHandlerFactory.cs @@ -4,13 +4,13 @@ namespace Microsoft.Extensions.ServiceDiscovery.Http; /// -/// Factory which creates instances which resolve endpoints using service discovery +/// Represents a factory that creates instances that resolve endpoints using service discovery /// before delegating to a provided handler. /// public interface IServiceDiscoveryHttpMessageHandlerFactory { /// - /// Creates an instance which resolve endpoints using service discovery before + /// Creates an instance that resolves endpoints using service discovery before /// delegating to a provided handler. /// /// The handler to delegate to. diff --git a/src/Libraries/Microsoft.Extensions.ServiceDiscovery/Internal/ServiceEndpointResolverResult.cs b/src/Libraries/Microsoft.Extensions.ServiceDiscovery/Internal/ServiceEndpointResolverResult.cs index 675941bb955..65161cac046 100644 --- a/src/Libraries/Microsoft.Extensions.ServiceDiscovery/Internal/ServiceEndpointResolverResult.cs +++ b/src/Libraries/Microsoft.Extensions.ServiceDiscovery/Internal/ServiceEndpointResolverResult.cs @@ -18,7 +18,7 @@ internal sealed class ServiceEndpointResolverResult(ServiceEndpointSource? endpo public Exception? Exception { get; } = exception; /// - /// Gets a value indicating whether resolution completed successfully. + /// Gets a value that indicates whether resolution completed successfully. /// [MemberNotNullWhen(true, nameof(EndpointSource))] public bool ResolvedSuccessfully => Exception is null; diff --git a/src/Libraries/Microsoft.Extensions.ServiceDiscovery/ServiceDiscoveryOptions.cs b/src/Libraries/Microsoft.Extensions.ServiceDiscovery/ServiceDiscoveryOptions.cs index a6fd7123aa7..793f058a2cd 100644 --- a/src/Libraries/Microsoft.Extensions.ServiceDiscovery/ServiceDiscoveryOptions.cs +++ b/src/Libraries/Microsoft.Extensions.ServiceDiscovery/ServiceDiscoveryOptions.cs @@ -12,10 +12,11 @@ namespace Microsoft.Extensions.ServiceDiscovery; public sealed class ServiceDiscoveryOptions { /// - /// Gets or sets a value indicating whether all URI schemes for URIs resolved by the service discovery system are allowed. - /// If this value is , all URI schemes are allowed. - /// If this value is , only the schemes specified in are allowed. + /// Gets or sets a value that indicates whether all URI schemes for URIs resolved by the service discovery system are allowed. /// + /// + /// to allow all URI schemes; to allow only schemes specified in . + /// public bool AllowAllSchemes { get; set; } = true; ///