NO-JIRA fixup versions doc

docs/user-manual/versions.adoc

@@ -16,39 +16,22 @@ NOTE: Follow the general upgrade procedure outlined in the xref:upgrading.adoc#u
 
 https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12315920&version=12353446[Full release notes]
 
+=== Highlights
 
-== Highlights
-
-* *Artemis Shell*:
-- Introduced a new feature, Artemis shell, as part of 2.31.0. When you run `./artemis shell`, a new terminal screen will help you navigate through the CLI commands.
-- The shell terminal will also be presented when you run `./artemis`.
-- You can use bash auto-complete. Run `./artemis auto-complete` to generate a bash script that provides auto-complete information for your bash shell.
-
-* *CLI Cluster Verification Tool*:
-- Added a CLI cluster verification tool to help you monitor your broker topologies. Type `./artemis check cluster` to access this functionality.
-
-* *Cluster Message Count Verification*:
-- You can now use `./artemis queue stat` to verify the message counts on the entire cluster topology when clustering is in use.
-
-* *AMQP Federation*:
-- Added AMQP Federation support to broker connections.
-
-* *MQTT Session State Persistence*:
-- MQTT Session State is now persisted.
-
-* *Paging JDBC Persistence*:
-- Significantly improved the Paging JDBC Persistence.
-
-* *Documentation converted to AsciiDoc*
-
-* *Bug Fixes and Improvements*:
-- Many other bug fixes and improvements, as usual.
-
+* Introduced an xref:using-cli.adoc#artemis-shell[interactive shell] for running CLI command as well as xref:using-cli.adoc#bash-and-zsh-auto-complete[Bash & ZSH auto-complete support].
+* Added a CLI cluster verification tool to help monitor broker topologies.
+Use via the `check cluster` command.
+* The `queue stat` command is now able to to verify the message counts on the entire cluster topology when clustering is in use.
+* Added xref:amqp-broker-connections.adoc#federation[AMQP Federation] support to broker connections.
+* xref:mqtt.adoc#persistent-subscriptions[MQTT subscription state is now persisted].
+* Significantly improved the Paging JDBC Persistence.
+* Converted much of the documentation from MarkDown to AsciiDoc.
+See https://issues.apache.org/jira/browse/ARTEMIS-4383[ARTEMIS-4383] for more details.
+* Many other bug fixes and improvements.
 
-== Upgrading from 2.30.0
+=== Upgrading from 2.30.0
 
-* You should be able to use `artemis upgrade` to switch the Artemis home of your installation and migrate configuration files.
-* Note that with the introduction of the new Artemis shell feature, when you invoke `./artemis`, it will now start the new terminal shell to navigate through the CLI commands.
+* Due to https://issues.apache.org/jira/browse/ARTEMIS-4372[ARTEMIS-4372] and the introduction of the new Artemis shell feature when you invoke `./artemis` it will now start the new shell to navigate through the CLI commands rather than just spitting out the `help` text.
 
 == 2.30.0