Skip to content

Commit c70939a

Browse files
committed
Explain that FFs are not configuration
1 parent a407f19 commit c70939a

File tree

1 file changed

+16
-7
lines changed

1 file changed

+16
-7
lines changed

site/feature-flags.md

Lines changed: 16 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -21,14 +21,12 @@ upgrades](./upgrade.html#rolling-upgrades) of cluster members without
2121
shutting down the entire cluster**.
2222

2323
<p class="box-warning">
24-
This subsystem does not guarantee that all future changes in
25-
RabbitMQ can be implemented as feature flags and entirely backwards
26-
compatible with older release series. Therefore, <strong>a future
27-
version of RabbitMQ might still require a cluster-wide shutdown for
28-
upgrading</strong>.
24+
Feature flags are not meant to be used as a form of cluster configuration.
25+
After a successful rolling upgrade, users should enable all feature flags.
2926

30-
Please always read <a href="./changelog.html">release notes</a> to see if a rolling
31-
upgrade to the next minor or major RabbitMQ version is possible.
27+
Each feature flag will become mandatory at some point. For example,
28+
<a href="https://github.com/rabbitmq/rabbitmq-server/blob/main/release-notes/3.11.0.md#compatibility-notes">
29+
RabbitMQ 3.11 requires feature flags introduced in 3.8 to be enabled prior to the upgrade</a>.
3230
</p>
3331

3432
## <a id="tldr" class="anchor" href="#tldr">Quick summary (TL;DR)</a>
@@ -43,6 +41,17 @@ upgrade to the next minor or major RabbitMQ version is possible.
4341
RabbitMQ 3.7.x and 3.8.x nodes are compatible as long as no 3.8.x
4442
feature flags are enabled.
4543

44+
<p class="box-warning">
45+
This subsystem does not guarantee that all future changes in
46+
RabbitMQ can be implemented as feature flags and entirely backwards
47+
compatible with older release series. Therefore, <strong>a future
48+
version of RabbitMQ might still require a cluster-wide shutdown for
49+
upgrading</strong>.
50+
51+
Please always read <a href="./changelog.html">release notes</a> to see if a rolling
52+
upgrade to the next minor or major RabbitMQ version is possible.
53+
</p>
54+
4655
### The Two Main Commands
4756

4857
* To list feature flags:

0 commit comments

Comments
 (0)