diff --git a/docs/root/api-docs/xds_protocol.rst b/docs/root/api-docs/xds_protocol.rst index 74e4c8ee663d..caf6799bb469 100644 --- a/docs/root/api-docs/xds_protocol.rst +++ b/docs/root/api-docs/xds_protocol.rst @@ -427,17 +427,14 @@ names becomes empty, that means that the client is no longer interested in any r specified type. For :ref:`Listener ` and :ref:`Cluster ` resource -types, there is also a "wildcard" mode, which comes in two equivalent flavors. First flavor, -implicit, is triggered when the initial request on the stream for that resource type contains no -resource names. Second flavor, explicit, is triggered when a request (not necessarily an initial one -on the stream) for that resource type contains (among other names) a special name "*". Opting in -into the wildcard subscription means adding the wildcard subscription into the subscription state. -For wildcard requests, the server should use site-specific business logic to determine the full set -of resources that the client is interested in, typically based on the client's :ref:`node ` identification. -The client can opt out from the wildcard mode by unsubscribing from the "*" resource name. Note that -subsequently opting back into the wildcard mode can only be done with a request that adds the "*" -resource name to the subscription state. Additional resource names added to the subscription state -while being opted-in into the wildcard mode should not be ignored by the server. +types, there is also a "wildcard" mode, which is triggered by sending a request containing a special +resource name "*" in a list of resource names to subscribe to. As a special case, sending an initial +request with no resource names at all also triggers the wildcard mode. For wildcard requests, +the server should use site-specific business logic to determine the full set of resources that +the client is interested in, typically based on the client's :ref:`node ` identification. +The client can opt out from the wildcard mode by unsubscribing from the "*" resource name. +Additional resource names added to the subscription state while being opted-in into the wildcard +mode should not be ignored by the server. Client Behavior """""""""""""""