Documentation clarification about transient_nonexcl_queues feature deprecation

[Tazmaniac]

Is your feature request related to a problem? Please describe.

Per comments #12802 (comment)

We could deduce that after deprecation, only classic exclusive queues will be supported.
All other forms of classic queues without "durable:true" will not.

As the queue property is "durable:true" and not "transient:false" the affected queue types should be explicitly documented.

Describe the solution you'd like

Describe the feature flag in https://www.rabbitmq.com/docs/feature-flags .
Explicitly state that after disabling this feature flag, only classic exclusive queue without "durable:true" will be supported all other non-exclusive classic queue requiring "durable:true".

Describe alternatives you've considered

No response

Additional context

No response

[michaelklishin]

@Tazmaniac the docs are open source, so anyone can edit them. However, there are several factually incorrect claims in what you expect us to document.

The term "transient" is used in section dedicated to queue durability. In most client libraries durable is the only option to control the setting, so "transient" can only be expressed as "durable: false` but the term has been used in our docs for years.

Non-exclusive, transient/non-durable classic queues are still supported, and there are no plans to remove them in 4.1.0.
We cannot claim that "only classic exclusive queue without "durable:true" will be supported" since that is factually incorrect at the moment and will be incorrect till at least fall 2025, if not after that.

Finally, the combination of durable and exclusive flags does not make much sense, as the Queues guide tries to explain by covering queue durability and exclusivity in separate sections and as separate "kinds of queues" (long-lived and shared vs. short-lived and client session-specific).

Feature flags cannot be disabled once enabled. You will have to enable all feature flags eventually, there is no way around it, if you plan on upgrading RabbitMQ.

[michaelklishin]

I will not document any queue properties in the feature flags guide. It makes no sense to me.

I will add a mention to the Queues guide that non-durable non-exclusive queues are deprecated and will eventually be removed.

[michaelklishin]

I guess this list of deprecated features can be expanded, too. But deprecated features are not feature flags. They have nothing in common besides the fact that you can enable both.

[michaelklishin]

Done rabbitmq/rabbitmq-website@74e96c4

[michaelklishin]

rabbitmq/rabbitmq-website@6c01cc1

[Tazmaniac]

Thank you, this is perfect !!