Anonymitaet commented on code in PR #16057:
URL: https://github.com/apache/pulsar/pull/16057#discussion_r897460787


##########
site2/docs/concepts-messaging.md:
##########
@@ -102,7 +102,7 @@ You can compress messages published by producers during 
transportation. Pulsar c
 
 When batching is enabled, the producer accumulates and sends a batch of 
messages in a single request. The batch size is defined by the maximum number 
of messages and the maximum publish latency. Therefore, the backlog size 
represents the total number of batches instead of the total number of messages.
 
-In Pulsar, batches are tracked and stored as single units rather than as 
individual messages. Consumer unbundles a batch into individual messages. 
However, scheduled messages (configured through the `deliverAt` or the 
`deliverAfter` parameter) are always sent as individual messages even batching 
is enabled.
+In Pulsar, batches are tracked and stored as single units rather than as 
individual messages. Consumers will unbundle a batch into individual messages. 
However, scheduled messages (configured through the `deliverAt` or the 
`deliverAfter` parameter) are always sent as individual messages even when 
batching is enabled.

Review Comment:
   ```suggestion
   In Pulsar, batches are tracked and stored as single units rather than as 
individual messages. Consumers unbundle a batch into individual messages. 
However, scheduled messages (configured through the `deliverAt` or the 
`deliverAfter` parameter) are always sent as individual messages even when 
batching is enabled.
   ```
   
   Write in the simple present tense as much as possible if you are covering 
facts that were, are, and forever shall be true. 
https://docs.google.com/document/d/1lc5j4RtuLIzlEYCBo97AC8-U_3Erzs_lxpkDuseU0n4/edit#bookmark=id.e8uqh1awkcnp
   
   



##########
site2/docs/concepts-messaging.md:
##########
@@ -582,7 +585,7 @@ In the diagram below, **Consumer-C-1** and **Consumer-C-2** 
are able to subscrib
 
 #### Key_Shared
 
-In *Key_Shared* type, multiple consumers can attach to the same subscription. 
Messages are delivered in a distribution across consumers and message with same 
key or same ordering key are delivered to only one consumer. No matter how many 
times the message is re-delivered, it is delivered to the same consumer. When a 
consumer connected or disconnected will cause served consumer change for some 
key of message.
+In *Key_Shared* type, multiple consumers can attach to the same subscription. 
Messages are delivered in a distribution across consumers and messages with the 
same key or same ordering key are delivered to only one consumer. No matter how 
many times the message is re-delivered, it is delivered to the same consumer. 
When a consumer connects or disconnects it will cause the served consumer to 
change for some message keys.

Review Comment:
   ```suggestion
   In *Key_Shared* type, multiple consumers can attach to the same 
subscription. Messages are delivered in a distribution across consumers and 
messages with the same key or same ordering key are delivered to only one 
consumer. No matter how many times the message is re-delivered, it is delivered 
to the same consumer. When a consumer connects or disconnects, it causes the 
served consumer to change some message keys.
   ```
   
   is this correct?



-- 
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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to