[Doc] compatibility naming rule for the retry topic

[poorbarcode]

Search before asking

• I searched in the issues and found nothing similar.

What issue do you find in Pulsar docs?

The default naming rule of Retry topic is {tenant}/{namespaces}/{topic}-{sub}-RETRY, see: https://pulsar.apache.org/docs/3.0.x/concepts-messaging/#retry-letter-topic

The rule before version 2.8 was {tenant}/{namespaces}/{sub}-RETRY, and if there is a ZK node /admin/partitioned-topics/{namespace}-RETRY, Pulsar will still use the rule {tenant}/{namespaces}/{sub}-RETRY even if the version of Pulsar is larger than 2.8. This part of the explanation is not reflected in the documentation.

Related PR

• #6449 Support Consumers Set Custom Retry Delay
• #10129 fix the default retry letter and dead letter topic name

What is your suggestion?

Remove this compatibility logic or add a document that explains it.

Any reference?

Are you willing to submit a PR?

• I'm willing to submit a PR!

[github-actions]

The issue had no activity for 30 days, mark with Stale label.