Apply suggestions from code review

Co-authored-by: Nick <[email protected]>
Co-authored-by: Techassi <[email protected]>

Author: 3 people

modules/ROOT/pages/release-notes.adoc

@@ -46,7 +46,7 @@ Here are the headings you can use for the next release. Saves time checking inde
 
 Vulnerabilities::
 
-* More than 142 CVEs were fixed in the Stackable product images. This includes 11 CVEs of critical and 55 CVEs of high severity.
+* More than 142 CVEs were fixed in the Stackable product images. This includes 11 critical and 55 high-severity CVEs.
 
 Improved Authentication::
 
@@ -67,13 +67,17 @@ Logging::
 
 Monitoring::
 
-* In SDP 24.7 we upgraded the version of [JMX Exporter](https://github.com/prometheus/jmx_exporter) from 0.20 to 1.0.1. This is the tool which allows us to expose JMX metrics in Prometheus and is in use for Hadoop, HBase, Hive, Kafka, Spark, Trino and ZooKeeper. Unfortunately the version 1.0.1 has a severe performance degradation which has been [fixed upstream](https://github.com/prometheus/jmx_exporter/pull/1009) but is not yet released. This SDP release 24.11 contains a fixed version bringing performance back to normal levels.
+* https://github.com/prometheus/jmx_exporter[JMX Exporter] is a tool which allows us to expose JMX metrics as Prometheus metrics.
+  It is used by the following products: Hadoop, HBase, Hive, Kafka, Spark, Trino and ZooKeeper.
+  In the previous SDP release (24.7) we upgraded JMX Exporter from 0.20 to 1.0.1.
+  Unfortunately version 1.0.1 has a severe performance degradation which has been https://github.com/prometheus/jmx_exporter/pull/1009[fixed upstream] but is not yet released.
+  This SDP release (24.11) contains a fixed version bringing performance back to normal levels.
 
 Security::
 
-* The Stackable Data Platform now supports provisioning TLS certificates using cert-manager.
-* Added support for customizing sAMAccountName generation in secret operator.
-* The Stackable Secret Operator now requests permission to read Listeners, which is required to provision secrets for listener volumes with `listeners.stackable.tech/listener-name`.
+* The Stackable Data Platform now supports provisioning TLS certificates using https://cert-manager.io/[cert-manager].
+* Added support for customizing `sAMAccountName` generation in secret operator.
+* The Stackable Secret Operator now requests permission to read Listeners, which is required to provision secrets for listener volumes with the `listeners.stackable.tech/listener-name` annotation.
 
 Commons::
 
@@ -87,17 +91,19 @@ Listener::
 
 Dependencies::
 
-* Apache HBase: The hadoop-azure module was added to the image and is contained in the classpath. This makes it possible to use the Azure Data Lake Storage Gen2 (ADLS) instead of HDFS. See the usage guide for detailed information. 
+* Apache HBase: The hadoop-azure module was added to the image and is contained in the classpath. This makes it possible to use the Azure Data Lake Storage Gen2 (ADLS) instead of HDFS. See the xref:hbase:usage-guide/adls.adoc[usage guide] for detailed information.
 
 Operations::
 
 * The Stackable Operator for HDFS now supports upgrading existing HDFS installations. This process requires some manual intervention, however.
 
 Misc::
 
-* Apache NiFi: permit users to configure allowed hosts when NiFi is running behind a proxy. The proxy host check is now turned off by default. See documentation https://docs.stackable.tech/home/nightly/nifi/usage_guide/security#host-header-check[here].
-* Apache Airflow: Allow custom arbitrary python code in webserver_config.py.
-* Apache Superset: Allow custom arbitrary python code in superset_config.py
+* Apache NiFi: Permit users to configure allowed hosts when NiFi is running behind a proxy.
+  The proxy host check is now disabled by default.
+  See documentation xref:nifi:usage_guide/security#host-header-check[here].
+* Apache Airflow: Allow custom arbitrary python code in `webserver_config.py`.
+* Apache Superset: Allow custom arbitrary python code in `superset_config.py`.
 * The size of the operator deployed CRDs was reduced significantly https://github.com/stackabletech/issues/issues/627[here].
 
 Images::