diff --git a/xds/internal/xdsclient/client.go b/xds/internal/xdsclient/client.go index 144cb5bd7..eba00907d 100644 --- a/xds/internal/xdsclient/client.go +++ b/xds/internal/xdsclient/client.go @@ -32,9 +32,9 @@ import ( type XDSClient interface { // WatchResource uses xDS to discover the resource associated with the // provided resource name. The resource type implementation determines how - // xDS requests are sent out and how responses are deserialized and - // validated. Upon receipt of a response from the management server, an - // appropriate callback on the watcher is invoked. + // xDS responses are are deserialized and validated, as received from the + // xDS management server. Upon receipt of a response from the management + // server, an appropriate callback on the watcher is invoked. // // Most callers will not have a need to use this API directly. They will // instead use a resource-type-specific wrapper API provided by the relevant diff --git a/xds/internal/xdsclient/clientimpl_watchers.go b/xds/internal/xdsclient/clientimpl_watchers.go index 1b8ebe131..ed4ee360f 100644 --- a/xds/internal/xdsclient/clientimpl_watchers.go +++ b/xds/internal/xdsclient/clientimpl_watchers.go @@ -27,10 +27,10 @@ import ( ) // WatchResource uses xDS to discover the resource associated with the provided -// resource name. The resource type implementation determines how xDS requests -// are sent out and how responses are deserialized and validated. Upon receipt -// of a response from the management server, an appropriate callback on the -// watcher is invoked. +// resource name. The resource type implementation determines how xDS responses +// are are deserialized and validated, as received from the xDS management +// server. Upon receipt of a response from the management server, an +// appropriate callback on the watcher is invoked. func (c *clientImpl) WatchResource(rType xdsresource.Type, resourceName string, watcher xdsresource.ResourceWatcher) (cancel func()) { // Return early if the client is already closed. // diff --git a/xds/internal/xdsclient/xdsresource/resource_type.go b/xds/internal/xdsclient/xdsresource/resource_type.go index 0e398cad9..3f23378b7 100644 --- a/xds/internal/xdsclient/xdsresource/resource_type.go +++ b/xds/internal/xdsclient/xdsresource/resource_type.go @@ -46,9 +46,9 @@ func init() { type Producer interface { // WatchResource uses xDS to discover the resource associated with the // provided resource name. The resource type implementation determines how - // xDS requests are sent out and how responses are deserialized and - // validated. Upon receipt of a response from the management server, an - // appropriate callback on the watcher is invoked. + // xDS responses are are deserialized and validated, as received from the + // xDS management server. Upon receipt of a response from the management + // server, an appropriate callback on the watcher is invoked. WatchResource(rType Type, resourceName string, watcher ResourceWatcher) (cancel func()) }