[GitHub] [pulsar] codelipenghui commented on a diff in pull request #15709: [improve][doc] Add a limitation for key_shared subscription type

[GitBox <gi...@apache.org>]

codelipenghui commented on code in PR #15709:
URL: https://github.com/apache/pulsar/pull/15709#discussion_r981145806


##########
site2/docs/concepts-messaging.md:
##########
@@ -633,10 +641,14 @@ producer = client.create_producer(topic='my-topic', batching_type=pulsar.Batchin
 </Tabs>
 ````
 
-> **Limitations of Key_Shared type**  
-> When you use Key_Shared type, be aware that:
-> * You need to specify a key or orderingKey for messages.
-> * You cannot use cumulative acknowledgment with Key_Shared type.
+:::caution
+**Limitations of Key_Shared type** 
+
+When you use Key_Shared type, be aware that:
+  * You need to specify a key or orderingKey for messages.
+  * You cannot use cumulative acknowledgment with Key_Shared type.
+  * When the position of the newest message in a topic is `X`, a key-shared consumer that is newly attached to the same subscription and connected to the topic will **not** receive any messages until the position of the oldest unacknowledged message in this subscription is newer than or equal to `X`. 

Review Comment:
   ```suggestion
     * When the position of the newest message in a topic is `X`, a key-shared consumer that is newly attached to the same subscription and connected to the topic will **not** receive any messages until all the messages before `X` have been acknowledged. 
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org