[pulsar-site] branch main updated: [improve][doc] Add note on client/broker compatibility (#407)

[mm...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

mmarshall pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pulsar-site.git


The following commit(s) were added to refs/heads/main by this push:
     new d4dae4746f7 [improve][doc] Add note on client/broker compatibility (#407)
d4dae4746f7 is described below

commit d4dae4746f771c41e58b69ffecbf7cc5a2128f7c
Author: Chris Bono <ch...@gmail.com>
AuthorDate: Thu Jun 8 23:23:38 2023 -0500

    [improve][doc] Add note on client/broker compatibility (#407)
    
    * Add note on client/broker compatibility
    
    * Update docs/client-libraries.md
    
    Co-authored-by: Michael Marshall <mi...@gmail.com>
    
    ---------
    
    Co-authored-by: Michael Marshall <mi...@gmail.com>
---
 docs/client-libraries.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/client-libraries.md b/docs/client-libraries.md
index 5e58164adab..87138585c78 100644
--- a/docs/client-libraries.md
+++ b/docs/client-libraries.md
@@ -32,6 +32,14 @@ Pulsar supports the following language-agnostic client libraries:
 | REST      | [User doc](client-libraries-rest.md)      | [Bundled](pathname:///release-notes/)             | [Bundled](https://github.com/apache/pulsar/tree/master/pulsar-broker)    |
 | WebSocket | [User doc](client-libraries-websocket.md) | [Standalone](pathname:///release-notes/client-ws) | [Bundled](https://github.com/apache/pulsar/tree/master/pulsar-websocket) |
 
+:::note 
+
+**Client / Broker compatibility**
+
+A design goal of Pulsar is to ensure full compatibility between all versions of the client and the broker. When a client connects to a broker they agree upon a version of the protocol to use. As a result, new features that rely on an updates to the protocol are only available when using both newer clients and newer brokers.
+
+:::
+
 ## Feature matrix
 
 The [Client Feature Matrix](/client-feature-matrix/) page provides an overview of the latest feature supportability on language-specific clients.