Make filename and asciidoc identifers consistent

Comments in nav
quarkiverse · Dec 11, 2024 · 3937b3d · 3937b3d
1 parent 80278ed
commit 3937b3d
Show file tree

Hide file tree

Showing 79 changed files with 189 additions and 89 deletions.
diff --git a/docs/modules/ROOT/images/code.quarkus.io.png → docs/modules/ROOT/images/code-quarkus-io.png b/docs/modules/ROOT/images/code.quarkus.io.png → docs/modules/ROOT/images/code-quarkus-io.png
diff --git a/...OOT/images/release-notes-2.10.0-since.png → ...OOT/images/release-notes-2-10-0-since.png b/...OOT/images/release-notes-2.10.0-since.png → ...OOT/images/release-notes-2-10-0-since.png
diff --git a/...es/release-notes-2.7.0-devui-services.png → ...es/release-notes-2-7-0-devui-services.png b/...es/release-notes-2.7.0-devui-services.png → ...es/release-notes-2-7-0-devui-services.png
diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc
@@ -1,3 +1,4 @@
+// user-guide
 * xref:user-guide/index.adoc[User guide]
 ** xref:user-guide/create-project.adoc[Create a new project]
 ** xref:user-guide/first-soap-web-service.adoc[Your first SOAP Web service]
@@ -27,11 +28,16 @@
 *** xref:user-guide/advanced-client-topics/prevent-resource-leaks.adoc[Prevent resource leaks]
 ** xref:user-guide/camel-integration.adoc[Camel Integration]
 ** xref:user-guide/examples.adoc[Examples]
+
+// security-guide
 * xref:security-guide/index.adoc[Security guide]
-** xref:user-guide/ssl.adoc[SSL, TLS and HTTPS]
-** xref:user-guide/auth.adoc[Authentication and authorization]
-** xref:security-guide/ws-securitypolicy-auth.adoc[WS-SecurityPolicy Authentication]
+** xref:user-guide/ssl-tls-https.adoc[SSL, TLS and HTTPS]
+** xref:user-guide/authentication-authorization.adoc[Authentication and authorization]
+** xref:security-guide/ws-securitypolicy-authentication-authorization.adoc[WS-SecurityPolicy Authentication]
+
+// release-notes
 * xref:release-notes/index.adoc[Release notes]
+
 ifeval::[{doc-is-main} == true]
 ** xref:release-notes/3.17.1.adoc[3.17.1]
 ** xref:release-notes/3.17.0.adoc[3.17.0]
@@ -69,10 +75,15 @@ ifeval::[{doc-is-main} == true]
 ** xref:release-notes/2.2.1.adoc[2.2.1 LTS]
 ** xref:release-notes/2.2.0.adoc[2.2.0 LTS]
 endif::[]
+
+// release-planning
 * xref:release-planning.adoc[Release planning]
 * xref:contributor-guide/index.adoc[Contributor guide]
 ** xref:contributor-guide/releasing.adoc[Releasing]
+
+// reference
 * xref:reference/index.adoc[Reference]
+
 // extensions: START
 ** xref:reference/extensions/quarkus-cxf.adoc[Quarkus CXF]
 ** xref:reference/extensions/quarkus-cxf-rt-features-metrics.adoc[Metrics Feature]

diff --git a/docs/modules/ROOT/pages/contributor-guide/index.adoc b/docs/modules/ROOT/pages/contributor-guide/index.adoc
@@ -1,4 +1,4 @@
-[[contributor-guide]]
+[[contributor-guide-index]]
 = Contributor guide
 
 

diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc
@@ -1,15 +1,17 @@
-[[cxf-extension-for-quarkus]]
+[[quarkus-cxf-index]]
 = {quarkus-cxf-project-name}
 
 This project aims at porting http://cxf.apache.org/[Apache CXF] to https://quarkus.io/[Quarkus] runtime
 including full support for producing https://quarkus.io/container-first/[GraalVM native images].
 
 [IMPORTANT]
+====
 While http://cxf.apache.org/[Apache CXF] implements wide range of standards and specifications,
 {quarkus-cxf-project-name} is currently focusing *only* on supporting the ones related to
 *Simple Object Access Protocol* (https://en.wikipedia.org/wiki/SOAP[SOAP])
 and *Java API for XML Web Services* (https://en.wikipedia.org/wiki/JAX-WS[JAX-WS]).
 Refer to xref:reference/index.adoc[Reference] to learn which parts of CXF are supported.
+====
 
 The documentation is divided into the following main parts:
 

diff --git a/...T/pages/reference/extensions/quarkus-cxf-integration-tracing-opentelemetry.adoc b/...T/pages/reference/extensions/quarkus-cxf-integration-tracing-opentelemetry.adoc
@@ -15,9 +15,12 @@ endif::[]
 
 Generate https://opentelemetry.io/[OpenTelemetry] https://opentelemetry.io/docs/concepts/signals/traces/[traces].
 
-IMPORTANT: OpenTelemetry Metrics and Logging are not supported yet on neither Quarkus nor CXF side,
-           hence {quarkus-cxf-project-name} cannot support them either. Tracing is thus
-           the only OpenTelemetry feature supported by this extension.
+[IMPORTANT]
+====
+OpenTelemetry Metrics and Logging are not supported yet on neither Quarkus nor CXF side,
+hence {quarkus-cxf-project-name} cannot support them either. Tracing is thus
+the only OpenTelemetry feature supported by this extension.
+====
 
 
 [id="quarkus-cxf-integration-tracing-opentelemetry-maven-coordinates"]

diff --git a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-features-metrics.adoc b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-features-metrics.adoc
@@ -15,9 +15,12 @@ endif::[]
 
 Collect metrics using https://micrometer.io/[Micrometer].
 
-IMPORTANT: Unlike https://cxf.apache.org/docs/metrics.html[CXF Metrics feature],
-           this {quarkus-cxf-project-name} extension does not support https://cxf.apache.org/docs/dropwizard-metrics.html[Dropwizard Metrics].
-           Only Micrometer is supported.
+[IMPORTANT]
+====
+Unlike https://cxf.apache.org/docs/metrics.html[CXF Metrics feature],
+this {quarkus-cxf-project-name} extension does not support https://cxf.apache.org/docs/dropwizard-metrics.html[Dropwizard Metrics].
+Only Micrometer is supported.
+====
 
 
 [id="quarkus-cxf-rt-features-metrics-maven-coordinates"]

diff --git a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-ws-security.adoc b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-ws-security.adoc
@@ -1292,8 +1292,11 @@ To work around the fact that `org.apache.cxf.ws.security.trust.STSClient` does n
 cannot thus be used as a CDI bean type, you can use the wrapper class
 `io.quarkiverse.cxf.ws.security.sts.client.STSClientBean` instead.
 
-Tip: Check the xref:reference/extensions/quarkus-cxf-services-sts.adoc[Security Token Service (STS)] extension page
+[TIP]
+====
+Check the xref:reference/extensions/quarkus-cxf-services-sts.adoc[Security Token Service (STS)] extension page
 for more information about WS-Trust.
+====
 
 *Environment variable*: `+++QUARKUS_CXF_CLIENT__CLIENT_NAME__SECURITY_STS_CLIENT+++` +
 *Since Quarkus CXF*: 3.8.0

diff --git a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf.adoc b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf.adoc
@@ -57,8 +57,8 @@ There are several chapters in the xref:user-guide/index.adoc[User guide] coverin
 * xref:user-guide/configuration.adoc[Configuration]
 * xref:user-guide/package-for-jvm-and-native.adoc[Package for JVM and native]
 * xref:user-guide/payload-logging.adoc[Logging]
-* xref:user-guide/ssl.adoc[SSL]
-* xref:user-guide/auth.adoc[Authentication and authorization]
+* xref:user-guide/ssl-tls-https.adoc[SSL]
+* xref:user-guide/authentication-authorization.adoc[Authentication and authorization]
 * xref:user-guide/advanced-soap-client-topics.adoc[Advanced SOAP client topics]
 * xref:user-guide/advanced-service-topics/running-behind-a-reverse-proxy.adoc[Running behind a reverse proxy]
 * xref:user-guide/contract-first-code-first/generate-java-from-wsdl.adoc[Generate Java from WSDL]

diff --git a/docs/modules/ROOT/pages/reference/index.adoc b/docs/modules/ROOT/pages/reference/index.adoc
@@ -1,11 +1,11 @@
-[[reference]]
+[[reference-index]]
 = Reference
 
 [[extensions]]
 == {quarkus-cxf-project-name}
 
-Here is the list of extensions produced by this project.
-Please follow the links under the extension names to learn about how to use them, about their configuration and about any known limitations.
+The following table shows the {quarkus-cxf-project-name} extensions.
+Click the extension names to learn more about how to configure and use them, and about any known limitations.
 
 [cols="4,1,1,4"]
 |===
@@ -95,7 +95,7 @@ Out of https://cxf.apache.org/docs/transports.html[CXF Transports] only the foll
 
 * `quarkus-cxf` implements its own custom transport based on Quarkus and Vert.x for serving SOAP endpoints
 * HTTP client via `xref:reference/extensions/quarkus-cxf.adoc[quarkus-cxf]`, including
-** xref:user-guide/auth.adoc#_client_http_basic_authentication[Basic Authentication]
+** xref:user-guide/authentication-authorization.adoc[Basic Authentication]
 * https://cxf.apache.org/docs/asynchronous-client-http-transport.html[Asynchronous Client HTTP Transport]
   via `xref:reference/extensions/quarkus-cxf-rt-transports-http-hc5.adoc[quarkus-cxf-rt-transports-http-hc5]`
 
@@ -201,6 +201,7 @@ Karaf
 
 |===
 
+[[supported-cxf-annotations]]
 == Supported CXF annotations
 
 Here is the status of https://cxf.apache.org/docs/annotations.html[CXF annotations] on Quarkus.

diff --git a/docs/modules/ROOT/pages/release-notes/2.2.0.adoc b/docs/modules/ROOT/pages/release-notes/2.2.0.adoc
@@ -1,3 +1,4 @@
+[[rn-2-2-0]]
 = {quarkus-cxf-project-name} 2.2.0 LTS release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/2.2.1.adoc b/docs/modules/ROOT/pages/release-notes/2.2.1.adoc
@@ -1,3 +1,4 @@
+[[rn-2-2-1]]
 = {quarkus-cxf-project-name} 2.2.1 LTS release notes
 
 == New and noteworthy in {quarkus-cxf-project-name}

diff --git a/docs/modules/ROOT/pages/release-notes/2.2.2.adoc b/docs/modules/ROOT/pages/release-notes/2.2.2.adoc
@@ -1,3 +1,4 @@
+[[rn-2-2-2]]
 = {quarkus-cxf-project-name} 2.2.2 LTS release notes
 
 == Fixed bugs

diff --git a/docs/modules/ROOT/pages/release-notes/2.3.0.adoc b/docs/modules/ROOT/pages/release-notes/2.3.0.adoc
@@ -1,3 +1,4 @@
+[[rn-2-3-0]]
 = {quarkus-cxf-project-name} 2.3.0 release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/2.3.1.adoc b/docs/modules/ROOT/pages/release-notes/2.3.1.adoc
@@ -1,3 +1,4 @@
+[[rn-2-3-1]]
 = {quarkus-cxf-project-name} 2.3.1 release notes
 
 == New and noteworthy in {quarkus-cxf-project-name}

diff --git a/docs/modules/ROOT/pages/release-notes/2.4.0.adoc b/docs/modules/ROOT/pages/release-notes/2.4.0.adoc
@@ -1,3 +1,4 @@
+[[rn-2-4-0]]
 = {quarkus-cxf-project-name} 2.4.0 release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/2.5.0.adoc b/docs/modules/ROOT/pages/release-notes/2.5.0.adoc
@@ -1,3 +1,4 @@
+[[rn-2-5-0]]
 = {quarkus-cxf-project-name} 2.5.0 release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/2.6.0.adoc b/docs/modules/ROOT/pages/release-notes/2.6.0.adoc
@@ -1,3 +1,4 @@
+[[rn-2-6-0]]
 = {quarkus-cxf-project-name} 2.6.0 release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/2.6.1.adoc b/docs/modules/ROOT/pages/release-notes/2.6.1.adoc
@@ -1,3 +1,4 @@
+[[rn-2-6-1]]
 = {quarkus-cxf-project-name} 2.6.1 release notes
 
 This maintenance release brings no fixes visible in end user applications.

diff --git a/docs/modules/ROOT/pages/release-notes/2.7.0.adoc b/docs/modules/ROOT/pages/release-notes/2.7.0.adoc
@@ -1,3 +1,4 @@
+[[rn-2-7-0]]
 = {quarkus-cxf-project-name} 2.7.0 release notes
 
 == Important dependency upgrades:
@@ -41,7 +42,7 @@ There are now separate cards listing CXF http://localhost:8080/q/dev-ui/io.quark
 
 Here is a screenshot of the http://localhost:8080/q/dev-ui/io.quarkiverse.cxf.quarkus-cxf/service-endpoints[Service endpoints] card:
 
-image::release-notes-2.7.0-devui-services.png[DevUI]
+image::release-notes-2-7-0-devui-services.png[DevUI]
 
 
 === Schema validation configurable via `application.properties`
@@ -60,8 +61,8 @@ as long as `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-c
 
 === Documentation improvements
 
-* New `xref:user-guide/ssl.adoc[SSL guide]`
-* New `xref:user-guide/auth.adoc[Authentication and authorization guide]`
+* New `xref:user-guide/ssl-tls-https.adoc[SSL guide]`
+* New `xref:user-guide/authentication-authorization.adoc[Authentication and authorization guide]`
 * Improved the xref:user-guide/payload-logging.adoc[Logging guide]
 * Improved the documentation of `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-version[quarkus.cxf.client."client-name".version]`
   and `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-browser-type[quarkus.cxf.client."client-name".browser-type]`

diff --git a/docs/modules/ROOT/pages/release-notes/2.7.1.adoc b/docs/modules/ROOT/pages/release-notes/2.7.1.adoc
@@ -1,3 +1,4 @@
+[[rn-2-7-1]]
 = {quarkus-cxf-project-name} 2.7.1 release notes
 
 This maintenance release brings no fixes visible in end user applications.

diff --git a/docs/modules/ROOT/pages/release-notes/3.10.0.adoc b/docs/modules/ROOT/pages/release-notes/3.10.0.adoc
@@ -1,3 +1,4 @@
+[[rn-3-10-0]]
 = {quarkus-cxf-project-name} 3.10.0 release notes
 
 == Important dependency upgrades
@@ -35,7 +36,7 @@ We filed https://issues.apache.org/jira/browse/CXF-9003[CXF-9003] to see whether
 
 * All configuration properties are now tagged with the version of {quarkus-cxf-project-name} since which they exist.
 +
-image::release-notes-2.10.0-since.png[The new since tag]
+image::release-notes-2-10-0-since.png[The new since tag]
 +
 * We added the xref:release-notes/index.adoc[Version table] to the Release notes page showing which version of
   {quarkus-cxf-project-name} uses which CXF version and which Quarkus Platform `<major>.<minor>` you should use

diff --git a/docs/modules/ROOT/pages/release-notes/3.11.0.adoc b/docs/modules/ROOT/pages/release-notes/3.11.0.adoc
@@ -1,3 +1,4 @@
+[[rn-3-11-0]]
 = {quarkus-cxf-project-name} 3.11.0 release notes
 
 == Important dependency upgrades

diff --git a/docs/modules/ROOT/pages/release-notes/3.11.1.adoc b/docs/modules/ROOT/pages/release-notes/3.11.1.adoc
@@ -1,3 +1,4 @@
+[[rn-3-11-1]]
 = {quarkus-cxf-project-name} 3.11.1 release notes
 
 == New and noteworthy in {quarkus-cxf-project-name}

diff --git a/docs/modules/ROOT/pages/release-notes/3.12.0.adoc b/docs/modules/ROOT/pages/release-notes/3.12.0.adoc
@@ -1,3 +1,4 @@
+[[rn-3-12-0]]
 = {quarkus-cxf-project-name} 3.12.0 release notes
 
 == Important dependency upgrades

diff --git a/docs/modules/ROOT/pages/release-notes/3.13.0.adoc b/docs/modules/ROOT/pages/release-notes/3.13.0.adoc
@@ -1,3 +1,4 @@
+[[rn-3-13-0]]
 = {quarkus-cxf-project-name} 3.13.0 release notes
 
 == Important dependency upgrades
@@ -7,6 +8,7 @@
 
 == New and noteworthy in {quarkus-cxf-project-name}
 
+[[vert-x-httpclient-based-http-conduit]]
 === Vert.x HttpClient based HTTP Conduit
 
 As Vert.x is the preferred HTTP stack on Quarkus, we decided to implement a new HTTP Conduit based on Vert.x
@@ -37,7 +39,7 @@ or https://github.com/quarkiverse/quarkus-cxf/discussions[Discussions].
 
 The issue https://github.com/quarkiverse/quarkus-cxf/issues/1425[#1425] made us figure out
 that we had no tests at all for injecting `jakarta.xml.ws.WebServiceContext` using the `@jakarta.annotation.Resource` and `@jakarta.annotation.Resources` annotations.
-We not only added the the tests and fixed the malfunctioning case with `@CXFEndpoint("/my-path")`,
+We not only added the tests and fixed the malfunctioning case with `@CXFEndpoint("/my-path")`,
 but we also changed how injecting `@Resource WebServiceContext` was implemented.
 Instead of relying on the reflective CXF code that was run at application start,
 the scanning is now done at build time by Arc, the CDI container of Quarkus.

diff --git a/docs/modules/ROOT/pages/release-notes/3.13.1.adoc b/docs/modules/ROOT/pages/release-notes/3.13.1.adoc
@@ -1,3 +1,4 @@
+[[rn-3-13-1]]
 = {quarkus-cxf-project-name} 3.13.1 release notes
 
 == Important dependency upgrades
@@ -8,7 +9,7 @@
 
 === https://github.com/quarkiverse/quarkus-cxf/issues/1455[#1455] Vert.x HTTP client is incorrectly used as the default
 
-We introduced xref:release-notes/3.13.0.adoc#_vert_x_httpclient_based_http_conduit[Vert.x HttpClient based HTTP Conduit] in {quarkus-cxf-project-name} 3.13.0
+We introduced xref:release-notes/3.13.0.adoc#vert-x-httpclient-based-http-conduit[Vert.x HttpClient based HTTP Conduit] in {quarkus-cxf-project-name} 3.13.0
 and it was not supposed to replace the original `HttpURLConnection` based default conduit.
 However, we screwed the default handling which resulted in using `VertxHttpClientHTTPConduit` as a default in some cases.
 This was fixed in {quarkus-cxf-project-name} 3.13.1.

diff --git a/docs/modules/ROOT/pages/release-notes/3.14.0.adoc b/docs/modules/ROOT/pages/release-notes/3.14.0.adoc
@@ -1,3 +1,4 @@
+[[rn-3-14-0]]
 = {quarkus-cxf-project-name} 3.14.0 release notes
 
 == Important dependency upgrades
@@ -8,7 +9,7 @@
 
 === https://github.com/quarkiverse/quarkus-cxf/issues/1460[#1460] IllegalArgumentException: port p must be in range 0 <= p <= 65535 when using client-endpoint-url without explicit port
 
-When using the xref:release-notes/3.13.0.adoc#_vert_x_httpclient_based_http_conduit[new `VertxHttpClientHTTPConduitFactory`],
+When using the xref:release-notes/3.13.0.adoc#vert-x-httpclient-based-http-conduit[new `VertxHttpClientHTTPConduitFactory`],
 the handling of default ports for `http` and `https` client endpoint URLs was broken resulting in an `IllegalArgumentException`.
 This was fixed in {quarkus-cxf-project-name} 3.14.0.
 

diff --git a/docs/modules/ROOT/pages/release-notes/3.15.0.adoc b/docs/modules/ROOT/pages/release-notes/3.15.0.adoc
@@ -1,3 +1,4 @@
+[[rn-3-15-0]]
 = {quarkus-cxf-project-name} 3.15.0 LTS release notes
 
 This is the first release in the new 3.15 https://quarkus.io/blog/lts-releases/[LTS stream].

diff --git a/docs/modules/ROOT/pages/release-notes/3.8.0.adoc b/docs/modules/ROOT/pages/release-notes/3.8.0.adoc
@@ -1,3 +1,4 @@
+[[rn-3-8-0]]
 = {quarkus-cxf-project-name} 3.8.0 (LTS) release notes
 
 == Changes in Quarkus
@@ -34,7 +35,7 @@ The new Maven coordinates starting with {quarkus-cxf-project-name} 3.8.0 are `io
 
 The following parts of the documentation were improved:
 
-* The Reference page now contains xref:reference/index.adoc#_supported_cxf_annotations[List of supported CXF annotations].
+* The Reference page now contains xref:reference/index.adoc#supported-cxf-annotations[List of supported CXF annotations].
 * xref:reference/extensions/quarkus-cxf-rt-ws-security.adoc[WS-Security extension page]
 ** New example using xref:reference/index.adoc#extensions-quarkus-cxf-rt-ws-security-usage-ws-security-via-ws-securitypolicy[WS-SecurityPolicy]
 ** New configuration options for xref:reference/extensions/quarkus-cxf-rt-ws-security.adoc#quarkus-cxf_quarkus-cxf-client-client-name-security-sts-client[STSClient]

diff --git a/docs/modules/ROOT/pages/release-notes/3.8.1.adoc b/docs/modules/ROOT/pages/release-notes/3.8.1.adoc
@@ -1,3 +1,4 @@
+[[rn-3-8-1]]
 = {quarkus-cxf-project-name} 3.8.1 (LTS) release notes
 
 == Important dependency upgrades:
@@ -11,9 +12,9 @@
 
 === Mutual TLS (mTLS)
 
-Mutual TLS (mTLS) is now xref:user-guide/ssl.adoc#mtls[documented],
+Mutual TLS (mTLS) is now xref:user-guide/ssl-tls-https.adoc#mtls[documented],
 https://github.com/quarkiverse/quarkus-cxf/tree/main/integration-tests/mtls[tested]
-and and can be configured for clients via `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-key-store[quarkus.cxf.client."client-name".key*]` family of options.
+and can be configured for clients via `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-key-store[quarkus.cxf.client."client-name".key*]` family of options.
 
 === Keystores and truststores now looked up in the file system
 
@@ -41,7 +42,7 @@ Now there is a way to do so via security policy and Quarkus configuration.
 +
 In the policy file, the `AlgorithmSuite` has to be set to `CustomAlgorithmSuite`:
 +
-[[custom-algorithm-suite-example]]
+[[rn-3-8-1-custom-algorithm-suite-example]]
 [source,xml]
 ----
 <wsp:Policy wsu:Id="SecurityServiceEncryptThenSignPolicy"

diff --git a/docs/modules/ROOT/pages/release-notes/3.8.2.adoc b/docs/modules/ROOT/pages/release-notes/3.8.2.adoc
@@ -1,3 +1,4 @@
+[[rn-3-8-2]]
 = {quarkus-cxf-project-name} 3.8.2 (LTS) release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/3.8.3.adoc b/docs/modules/ROOT/pages/release-notes/3.8.3.adoc
@@ -1,3 +1,4 @@
+[[rn-3-8-3]]
 = {quarkus-cxf-project-name} 3.8.3 (LTS) release notes
 
 == New and noteworthy in {quarkus-cxf-project-name}

diff --git a/docs/modules/ROOT/pages/release-notes/3.8.4.adoc b/docs/modules/ROOT/pages/release-notes/3.8.4.adoc
@@ -1,3 +1,4 @@
+[[rn-3-8-4]]
 = {quarkus-cxf-project-name} 3.8.4 (LTS) release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/3.8.5.adoc b/docs/modules/ROOT/pages/release-notes/3.8.5.adoc
@@ -1,3 +1,4 @@
+[[rn-3-8-5]]
 = {quarkus-cxf-project-name} 3.8.5 (LTS) release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/3.8.6.adoc b/docs/modules/ROOT/pages/release-notes/3.8.6.adoc
@@ -1,3 +1,4 @@
+[[rn-3-8-6]]
 = {quarkus-cxf-project-name} 3.8.6 (LTS) release notes
 
 == Important dependency upgrades:

diff --git a/docs/modules/ROOT/pages/release-notes/3.9.0.adoc b/docs/modules/ROOT/pages/release-notes/3.9.0.adoc
@@ -1,3 +1,4 @@
+[[rn-3-9-0]]
 = {quarkus-cxf-project-name} 3.9.0 release notes
 
 == Important dependency upgrades

diff --git a/docs/modules/ROOT/pages/release-notes/index.adoc b/docs/modules/ROOT/pages/release-notes/index.adoc
@@ -1,3 +1,4 @@
+[[release-notes-index]]
 = Release notes
 
 ifeval::[{doc-is-main} != true]