[GitHub] [pulsar-site] Anonymitaet commented on a diff in pull request #651: [improve] [doc] Add compatibility reminders for retry queues

["Anonymitaet (via GitHub)" <gi...@apache.org>]

Anonymitaet commented on code in PR #651:
URL: https://github.com/apache/pulsar-site/pull/651#discussion_r1277017939


##########
docs/concepts-messaging.md:
##########
@@ -244,6 +244,13 @@ The default retry letter topic uses this format:
 <topicname>-<subscriptionname>-RETRY
 ```
 
+Note: In versions `2.6.x` and `2.7.x`, the default retry letter topic uses this format is `<subscriptionname>-RETRY`.
+If you are upgrading from version `2.6.x~2.7.x` to version `2.8.x` or greater, then you need to manually delete
+the historical retry letter topics and retry letter partitioned topics. Otherwise, Pulsar will continue to use the
+original topics, which were formatted with `<subscriptionname>-RETRY`. Rule `<subscriptionname>-RETRY` should be avoided
+to use, because if multiple topics under the same namespace have the same subscription, the retry message topic names
+for multiple topics will be the same, resulting in mutual consumption.

Review Comment:
   ```suggestion
   :::note
   
   - For Pulsar 2.6.x and 2.7.x, the default retry letter topic uses the format of `<subscriptionname>-RETRY`. If you upgrade from 2.6.x~2.7.x to 2.8.x or later, you need to delete historical retry letter topics and retry letter partitioned topics. Otherwise, Pulsar continues to use original topics, which are formatted with `<subscriptionname>-RETRY`. 
   
   - It is not recommended to use `<subscriptionname>-RETRY` because if multiple topics under the same namespace have the same subscription, then retry message topic names for multiple topics might be the same, which will result in mutual consumptions.
   
   :::
   ```



-- 
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