Make it extra clear that queue (stream) type cannot be set with a policy

rabbitmq · Aug 14, 2024 · f0c4693 · f0c4693
1 parent d3c1fa1
commit f0c4693
Show file tree

Hide file tree

Showing 2 changed files with 20 additions and 0 deletions.
diff --git a/docs/parameters.md b/docs/parameters.md
@@ -168,6 +168,16 @@ Global parameters are used by the MQTT plugin.
 
 ## Policies {#policies}
 
+:::tip
+Policies is a mechanism of configuring certain properties of groups
+of queues, streams, exchanges. They are designed for parameters that can change at runtime.
+:::
+
+:::note
+Since queue (stream) type is set at declaration time and cannot be changed, policies cannot
+be used to configure queue type, by design. To specify queue (stream) type, use [optional arguments](./queues#optional-arguments).
+:::
+
 Policies is **the recommended way** of configuring [optional arguments](./queues#optional-arguments)
 for queues, exchanges, and some plugins.
 

diff --git a/versioned_docs/version-3.13/parameters.md b/versioned_docs/version-3.13/parameters.md
@@ -168,6 +168,16 @@ Global parameters are used by the MQTT plugin.
 
 ## Policies {#policies}
 
+:::tip
+Policies is a mechanism of configuring certain properties of groups
+of queues, streams, exchanges. They are designed for parameters that can change at runtime.
+:::
+
+:::note
+Since queue (stream) type is set at declaration time and cannot be changed, policies cannot
+be used to configure queue type, by design. To specify queue (stream) type, use [optional arguments](./queues#optional-arguments).
+:::
+
 Policies is **the recommended way** of configuring [optional arguments](./queues#optional-arguments)
 for queues, exchanges, and some plugins.