From e31a09b063bcc368c3baf5dc9ca85ef7c9be6a58 Mon Sep 17 00:00:00 2001
From: Steven Jin Xuan <sjinxuan@microsoft.com>
Date: Wed, 18 Dec 2024 14:12:12 -0500
Subject: [PATCH] API docs clarification

Signed-off-by: Steven Jin Xuan <sjinxuan@microsoft.com>
---
 api/envoy/extensions/clusters/dns/v3/dns_cluster.proto | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/api/envoy/extensions/clusters/dns/v3/dns_cluster.proto b/api/envoy/extensions/clusters/dns/v3/dns_cluster.proto
index f08e7a368395..4266541e67b8 100644
--- a/api/envoy/extensions/clusters/dns/v3/dns_cluster.proto
+++ b/api/envoy/extensions/clusters/dns/v3/dns_cluster.proto
@@ -84,7 +84,9 @@ message DnsCluster {
   // :ref:`AUTO<envoy_v3_api_enum_value_extensions.clusters.common.dns.v3.DnsLookupFamily.AUTO>`.
   common.dns.v3.DnsLookupFamily dns_lookup_family = 8;
 
-  // If true, perform :ref:`logical DNS discovery <arch_overview_service_discovery_types_logical_dns>`.
-  // Otherwise, :ref:`strict DNS discovery <arch_overview_service_discovery_types_strict_dns>`
+  // If true, all returned addresses are considered to be associated with a single endpoint,
+  // which maps to :ref:`logical DNS discovery <arch_overview_service_discovery_types_logical_dns>`
+  // semantics. Otherwise, each address is considered to be a separate endpoint, which maps to
+  // :ref:`strict DNS discovery <arch_overview_service_discovery_types_strict_dns>` semantics.
   bool all_addresses_in_single_endpoint = 9;
 }