[camel-quarkus] branch master updated: Split doc pages to user-guide and contributor-guide directories and set redirects

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

[camel-quarkus] branch master updated: Split doc pages to user-guide and contributor-guide directories and set redirects

ppalaga
This is an automated email from the ASF dual-hosted git repository.

ppalaga pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git


The following commit(s) were added to refs/heads/master by this push:
     new b6d8209  Split doc pages to user-guide and contributor-guide directories and set redirects
b6d8209 is described below

commit b6d82093ad21051bc6cc0af4827aed92354739d0
Author: Peter Palaga <[hidden email]>
AuthorDate: Fri May 22 10:17:43 2020 +0200

    Split doc pages to user-guide and contributor-guide directories and set redirects
---
 docs/modules/ROOT/nav.adoc                         | 24 +++++++++++-----------
 .../ROOT/pages/{ => contributor-guide}/ci.adoc     |  1 +
 .../create-new-extension.adoc                      |  7 ++++---
 .../extension-documentation.adoc                   |  1 +
 .../extension-metadata.adoc                        |  1 +
 .../index.adoc}                                    |  5 +++--
 .../promote-jvm-to-native.adoc                     |  5 +++--
 .../{ => contributor-guide}/release-guide.adoc     |  1 +
 docs/modules/ROOT/pages/extensions/activemq.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/ahc-ws.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/ahc.adoc        |  4 ++--
 docs/modules/ROOT/pages/extensions/amqp.adoc       |  2 +-
 .../modules/ROOT/pages/extensions/attachments.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/avro-rpc.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/avro.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/aws-ec2.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws-ecs.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws-eks.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws-iam.adoc    |  2 +-
 .../modules/ROOT/pages/extensions/aws-kinesis.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/aws-kms.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws-lambda.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/aws-s3.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/aws-sdb.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws-sns.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws-sqs.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws-swf.adoc    |  2 +-
 .../ROOT/pages/extensions/aws-translate.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-cw.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-ddb.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-ec2.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-ecs.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-eks.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-iam.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-kms.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-mq.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-msk.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-s3.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-ses.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-sns.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/aws2-sqs.adoc   |  2 +-
 .../ROOT/pages/extensions/aws2-translate.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/azure.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/base64.adoc     |  2 +-
 .../ROOT/pages/extensions/bean-validator.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/bean.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/bindy.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/box.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/braintree.adoc  |  2 +-
 .../modules/ROOT/pages/extensions/cassandraql.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/consul.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/controlbus.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/core-cloud.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/core.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/couchbase.adoc  |  2 +-
 docs/modules/ROOT/pages/extensions/couchdb.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/cron.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/csv.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/dataformat.adoc |  2 +-
 .../ROOT/pages/extensions/debezium-mongodb.adoc    |  2 +-
 .../ROOT/pages/extensions/debezium-mysql.adoc      |  2 +-
 .../ROOT/pages/extensions/debezium-postgres.adoc   |  2 +-
 .../ROOT/pages/extensions/debezium-sqlserver.adoc  |  2 +-
 docs/modules/ROOT/pages/extensions/direct.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/dozer.adoc      |  2 +-
 .../ROOT/pages/extensions/elasticsearch-rest.adoc  |  2 +-
 .../modules/ROOT/pages/extensions/endpointdsl.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/exec.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/fhir.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/file-watch.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/file.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/ftp.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/github.adoc     |  2 +-
 .../ROOT/pages/extensions/google-bigquery.adoc     |  2 +-
 .../ROOT/pages/extensions/google-calendar.adoc     |  2 +-
 .../ROOT/pages/extensions/google-drive.adoc        |  2 +-
 .../modules/ROOT/pages/extensions/google-mail.adoc |  2 +-
 .../ROOT/pages/extensions/google-pubsub.adoc       |  2 +-
 .../ROOT/pages/extensions/google-sheets.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/graphql.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/groovy.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/grpc.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/gson.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/http.adoc       |  4 ++--
 docs/modules/ROOT/pages/extensions/hystrix.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/ical.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/infinispan.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/influxdb.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/jackson.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/jacksonxml.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/jaxb.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/jdbc.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/jira.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/jms.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/johnzon.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/jsonpath.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/kafka.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/kotlin.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/kubernetes.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/kudu.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/log.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/lzf.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/mail.adoc       |  2 +-
 .../ROOT/pages/extensions/microprofile-health.adoc |  2 +-
 .../pages/extensions/microprofile-metrics.adoc     |  2 +-
 .../ROOT/pages/extensions/mongodb-gridfs.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/mongodb.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/mustache.adoc   |  4 ++--
 docs/modules/ROOT/pages/extensions/netty-http.adoc |  4 ++--
 docs/modules/ROOT/pages/extensions/netty.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/nitrite.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/ognl.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/olingo4.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/openstack.adoc  |  2 +-
 .../modules/ROOT/pages/extensions/opentracing.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/paho.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/pdf.adoc        |  2 +-
 .../ROOT/pages/extensions/platform-http.adoc       |  4 ++--
 docs/modules/ROOT/pages/extensions/protobuf.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/pubnub.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/quartz.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/qute.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/rabbitmq.adoc   |  2 +-
 .../ROOT/pages/extensions/reactive-executor.adoc   |  2 +-
 .../ROOT/pages/extensions/reactive-streams.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/ref.adoc        |  2 +-
 .../ROOT/pages/extensions/rest-openapi.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/rest.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/salesforce.adoc |  2 +-
 .../ROOT/pages/extensions/sap-netweaver.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/scheduler.adoc  |  2 +-
 docs/modules/ROOT/pages/extensions/seda.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/servicenow.adoc |  2 +-
 docs/modules/ROOT/pages/extensions/servlet.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/sjms.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/sjms2.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/slack.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/snakeyaml.adoc  |  2 +-
 docs/modules/ROOT/pages/extensions/soap.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/sql.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/stream.adoc     |  4 ++--
 docs/modules/ROOT/pages/extensions/tagsoup.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/tarfile.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/telegram.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/timer.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/twitter.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/validator.adoc  |  2 +-
 docs/modules/ROOT/pages/extensions/vm.adoc         |  2 +-
 .../ROOT/pages/extensions/websocket-jsr356.adoc    |  2 +-
 docs/modules/ROOT/pages/extensions/xml-io.adoc     |  2 +-
 docs/modules/ROOT/pages/extensions/xml-jaxb.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/xml-jaxp.adoc   |  2 +-
 docs/modules/ROOT/pages/extensions/xpath.adoc      |  2 +-
 docs/modules/ROOT/pages/extensions/xslt.adoc       |  2 +-
 docs/modules/ROOT/pages/extensions/xstream.adoc    |  2 +-
 .../ROOT/pages/extensions/zip-deflater.adoc        |  2 +-
 docs/modules/ROOT/pages/extensions/zipfile.adoc    |  2 +-
 .../pages/list-of-camel-quarkus-extensions.adoc    |  2 +-
 docs/modules/ROOT/pages/{ => user-guide}/cdi.adoc  |  3 ++-
 .../ROOT/pages/{ => user-guide}/examples.adoc      |  5 +++--
 .../ROOT/pages/{ => user-guide}/first-steps.adoc   |  1 +
 .../{user-guide.adoc => user-guide/index.adoc}     |  3 ++-
 .../ROOT/pages/{ => user-guide}/native-mode.adoc   |  1 +
 .../ahc/runtime/src/main/doc/configuration.adoc    |  2 +-
 .../http/runtime/src/main/doc/configuration.adoc   |  2 +-
 .../runtime/src/main/doc/configuration.adoc        |  2 +-
 .../runtime/src/main/doc/configuration.adoc        |  2 +-
 .../runtime/src/main/doc/configuration.adoc        |  2 +-
 .../stream/runtime/src/main/doc/configuration.adoc |  2 +-
 .../doc-templates/extension-doc-page.adoc          |  2 +-
 170 files changed, 198 insertions(+), 186 deletions(-)

diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc
index a3d0ae0..a5d9fc5 100644
--- a/docs/modules/ROOT/nav.adoc
+++ b/docs/modules/ROOT/nav.adoc
@@ -1,13 +1,13 @@
-* xref:user-guide.adoc[User guide]
-** xref:first-steps.adoc[First steps]
-** xref:cdi.adoc[CDI]
-** xref:native-mode.adoc[Native mode]
-** xref:examples.adoc[Examples]
-* xref:contributor-guide.adoc[Contributor guide]
-** xref:create-new-extension.adoc[Create new extension]
-** xref:promote-jvm-to-native.adoc[Promote JVM extension to Native]
-** xref:extension-metadata.adoc[Extension metadata]
-** xref:extension-documentation.adoc[Extension documentation]
-** xref:ci.adoc[Continuous Integration]
-** xref:release-guide.adoc[Release guide]
+* xref:user-guide/index.adoc[User guide]
+** xref:user-guide/first-steps.adoc[First steps]
+** xref:user-guide/cdi.adoc[CDI]
+** xref:user-guide/native-mode.adoc[Native mode]
+** xref:user-guide/examples.adoc[Examples]
+* xref:contributor-guide/index.adoc[Contributor guide]
+** xref:contributor-guide/create-new-extension.adoc[Create new extension]
+** xref:contributor-guide/promote-jvm-to-native.adoc[Promote JVM extension to Native]
+** xref:contributor-guide/extension-metadata.adoc[Extension metadata]
+** xref:contributor-guide/extension-documentation.adoc[Extension documentation]
+** xref:contributor-guide/ci.adoc[Continuous Integration]
+** xref:contributor-guide/release-guide.adoc[Release guide]
 * xref:list-of-camel-quarkus-extensions.adoc[List of Camel Quarkus extensions]
diff --git a/docs/modules/ROOT/pages/ci.adoc b/docs/modules/ROOT/pages/contributor-guide/ci.adoc
similarity index 97%
rename from docs/modules/ROOT/pages/ci.adoc
rename to docs/modules/ROOT/pages/contributor-guide/ci.adoc
index 1f95983..d1db7fb 100644
--- a/docs/modules/ROOT/pages/ci.adoc
+++ b/docs/modules/ROOT/pages/contributor-guide/ci.adoc
@@ -1,5 +1,6 @@
 [[ci]]
 = Camel Quarkus CI Builds
+:page-aliases: ci.adoc
 
 == Branches
 
diff --git a/docs/modules/ROOT/pages/create-new-extension.adoc b/docs/modules/ROOT/pages/contributor-guide/create-new-extension.adoc
similarity index 92%
rename from docs/modules/ROOT/pages/create-new-extension.adoc
rename to docs/modules/ROOT/pages/contributor-guide/create-new-extension.adoc
index b09a78b..00358f9 100644
--- a/docs/modules/ROOT/pages/create-new-extension.adoc
+++ b/docs/modules/ROOT/pages/contributor-guide/create-new-extension.adoc
@@ -1,7 +1,8 @@
 [[create-a-new-extension]]
 = Create a new extension
+:page-aliases: create-new-extension.adoc
 
-1. You should know xref:contributor-guide.adoc#how-to-build[how to build].
+1. You should know xref:contributor-guide/index.adoc#how-to-build[how to build].
 
 2. Go through the https://quarkus.io/guides/extension-authors-guide[Quarkus extension author's guide] to get an idea of
    what is expected from you.
@@ -55,7 +56,7 @@ because the test project needs to get finished. You need to build `poms/bom` and
    Run `mvn -N cq:update-quarkus-metadata` from the source tree's root directory to re-generate the
    `quarkus-extension.yaml` file.
 +
-   Check the xref:extension-metadata.adoc[Extension metadata] page for more details about the `quarkus-extension.yaml` file
+   Check the xref:contributor-guide/extension-metadata.adoc[Extension metadata] page for more details about the `quarkus-extension.yaml` file
 
 7. Review the dependencies in the generated runtime and deployment modules. In case the given library is supported by
    Quarkus, you may want to add a dependency on the corresponding Quarkus extension.
@@ -67,7 +68,7 @@ because the test project needs to get finished. You need to build `poms/bom` and
 9. In case of problems, consult the https://quarkus.io/guides/extension-authors-guide[Quarkus extension author's guide],
    ask for help in the given GitHub issue or via https://gitter.im/apache/camel-quarkus[Camel Quarkus chat].
 
-10. Read the xref:extension-documentation.adoc[Extension documentation] page and add `configuration.adoc`,
+10. Read the xref:contributor-guide/extension-documentation.adoc[Extension documentation] page and add `configuration.adoc`,
    `usage.adoc`, etc. in `src/main/doc` directory of the runtime module if necessary.
 +
    After completing the extension documentation, run `mvn clean install -DskipTests`
diff --git a/docs/modules/ROOT/pages/extension-documentation.adoc b/docs/modules/ROOT/pages/contributor-guide/extension-documentation.adoc
similarity index 98%
rename from docs/modules/ROOT/pages/extension-documentation.adoc
rename to docs/modules/ROOT/pages/contributor-guide/extension-documentation.adoc
index ee841da..ba1ccc3 100644
--- a/docs/modules/ROOT/pages/extension-documentation.adoc
+++ b/docs/modules/ROOT/pages/contributor-guide/extension-documentation.adoc
@@ -1,4 +1,5 @@
 = Extension documentation
+:page-aliases: extension-documentation.adoc
 
 The documentation pages for the individual extensions are generated by the
 `https://github.com/apache/camel-quarkus/blob/master/tooling/package-maven-plugin/src/main/java/org/apache/camel/quarkus/maven/UpdateExtensionDocPageMojo.java[update-extension-doc-page]` mojo
diff --git a/docs/modules/ROOT/pages/extension-metadata.adoc b/docs/modules/ROOT/pages/contributor-guide/extension-metadata.adoc
similarity index 97%
rename from docs/modules/ROOT/pages/extension-metadata.adoc
rename to docs/modules/ROOT/pages/contributor-guide/extension-metadata.adoc
index 1a349e2..f31d2a1 100644
--- a/docs/modules/ROOT/pages/extension-metadata.adoc
+++ b/docs/modules/ROOT/pages/contributor-guide/extension-metadata.adoc
@@ -1,4 +1,5 @@
 = Extension metadata
+:page-aliases: extension-metadata.adoc
 
 == `quarkus-extension.yaml`
 
diff --git a/docs/modules/ROOT/pages/contributor-guide.adoc b/docs/modules/ROOT/pages/contributor-guide/index.adoc
similarity index 83%
rename from docs/modules/ROOT/pages/contributor-guide.adoc
rename to docs/modules/ROOT/pages/contributor-guide/index.adoc
index a89ba50..0c242d5 100644
--- a/docs/modules/ROOT/pages/contributor-guide.adoc
+++ b/docs/modules/ROOT/pages/contributor-guide/index.adoc
@@ -1,5 +1,6 @@
 [[contributor-guide]]
 = Contributor guide
+:page-aliases: contributor-guide.adoc
 
 [[prerequisites]]
 == Prerequisites
@@ -47,5 +48,5 @@ $ mvn clean install -Pnative
 
 == What's next?
 
-* xref:create-new-extension.adoc[Create new extension].
-* xref:promote-jvm-to-native.adoc[Promote a JVM extension to Native].
+* xref:contributor-guide/create-new-extension.adoc[Create new extension].
+* xref:contributor-guide/promote-jvm-to-native.adoc[Promote a JVM extension to Native].
diff --git a/docs/modules/ROOT/pages/promote-jvm-to-native.adoc b/docs/modules/ROOT/pages/contributor-guide/promote-jvm-to-native.adoc
similarity index 94%
rename from docs/modules/ROOT/pages/promote-jvm-to-native.adoc
rename to docs/modules/ROOT/pages/contributor-guide/promote-jvm-to-native.adoc
index 25d509c..185d0d6 100644
--- a/docs/modules/ROOT/pages/promote-jvm-to-native.adoc
+++ b/docs/modules/ROOT/pages/contributor-guide/promote-jvm-to-native.adoc
@@ -1,5 +1,6 @@
 [[promote-jvm-to-native]]
 = Promote JVM extension to Native
+:page-aliases: promote-jvm-to-native.adoc
 
 The directory `extensions-jvm` contains extensions that have not been tested in
 link:https://quarkus.io/guides/building-native-image[native mode] yet. Configuring the
@@ -108,7 +109,7 @@ $ {
    Make sure you run `mvn -N cq:update-quarkus-metadata` from the source tree's root directory to re-generate
    the `quarkus-extension.yaml` file. As a result the `unlisted: true` line should disappear.
 +
-   Check the xref:extension-metadata.adoc[Extension metadata] page for more details about the `quarkus-extension.yaml` file
+   Check the xref:contributor-guide/extension-metadata.adoc[Extension metadata] page for more details about the `quarkus-extension.yaml` file
 
 9. Add the integration test to an existing or new test category in `.github/test-categories.yaml`, for instance:
 +
@@ -137,4 +138,4 @@ mvn clean verify -P native
 from runtime to build time. The https://quarkus.io/guides/extension-authors-guide[Quarkus extension author's guide] may be a good
 ally for this.
 
-13. Please also check the xref:create-new-extension.adoc[Create new extension] page as it contains some useful tips for a good contribution.
+13. Please also check the xref:contributor-guide/create-new-extension.adoc[Create new extension] page as it contains some useful tips for a good contribution.
diff --git a/docs/modules/ROOT/pages/release-guide.adoc b/docs/modules/ROOT/pages/contributor-guide/release-guide.adoc
similarity index 96%
rename from docs/modules/ROOT/pages/release-guide.adoc
rename to docs/modules/ROOT/pages/contributor-guide/release-guide.adoc
index 8858377..c7d9a7e 100644
--- a/docs/modules/ROOT/pages/release-guide.adoc
+++ b/docs/modules/ROOT/pages/contributor-guide/release-guide.adoc
@@ -1,5 +1,6 @@
 [[ReleaseGuide-ReleaseGuide]]
 = Apache Camel Quarkus release process
+:page-aliases: release-guide.adoc
 
 The process is _mutatis mutandis_ the same as for the main Apache Camel repository - see
 https://camel.apache.org/manual/latest/release-guide.html With Camel Quarkus, adding `-Prelease` to
diff --git a/docs/modules/ROOT/pages/extensions/activemq.adoc b/docs/modules/ROOT/pages/extensions/activemq.adoc
index 4f4260e..b44022b 100644
--- a/docs/modules/ROOT/pages/extensions/activemq.adoc
+++ b/docs/modules/ROOT/pages/extensions/activemq.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/ahc-ws.adoc b/docs/modules/ROOT/pages/extensions/ahc-ws.adoc
index e5fbfa8..e2ae24e 100644
--- a/docs/modules/ROOT/pages/extensions/ahc-ws.adoc
+++ b/docs/modules/ROOT/pages/extensions/ahc-ws.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/ahc.adoc b/docs/modules/ROOT/pages/extensions/ahc.adoc
index e4ed750..3e11162 100644
--- a/docs/modules/ROOT/pages/extensions/ahc.adoc
+++ b/docs/modules/ROOT/pages/extensions/ahc.adoc
@@ -24,10 +24,10 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
   your application to send or receive requests using non-default encodings.
 
diff --git a/docs/modules/ROOT/pages/extensions/amqp.adoc b/docs/modules/ROOT/pages/extensions/amqp.adoc
index c0220ed..80681c6 100644
--- a/docs/modules/ROOT/pages/extensions/amqp.adoc
+++ b/docs/modules/ROOT/pages/extensions/amqp.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/attachments.adoc b/docs/modules/ROOT/pages/extensions/attachments.adoc
index 44c3bf0..8033c92 100644
--- a/docs/modules/ROOT/pages/extensions/attachments.adoc
+++ b/docs/modules/ROOT/pages/extensions/attachments.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/avro-rpc.adoc b/docs/modules/ROOT/pages/extensions/avro-rpc.adoc
index d9678fc..86ef6db 100644
--- a/docs/modules/ROOT/pages/extensions/avro-rpc.adoc
+++ b/docs/modules/ROOT/pages/extensions/avro-rpc.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/avro.adoc b/docs/modules/ROOT/pages/extensions/avro.adoc
index 3b7678c..5092c67 100644
--- a/docs/modules/ROOT/pages/extensions/avro.adoc
+++ b/docs/modules/ROOT/pages/extensions/avro.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
diff --git a/docs/modules/ROOT/pages/extensions/aws-ec2.adoc b/docs/modules/ROOT/pages/extensions/aws-ec2.adoc
index fa2455c..cf7680a 100644
--- a/docs/modules/ROOT/pages/extensions/aws-ec2.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-ec2.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-ecs.adoc b/docs/modules/ROOT/pages/extensions/aws-ecs.adoc
index 85bda0d..a0d6f15 100644
--- a/docs/modules/ROOT/pages/extensions/aws-ecs.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-ecs.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-eks.adoc b/docs/modules/ROOT/pages/extensions/aws-eks.adoc
index ecc9689..25a819c 100644
--- a/docs/modules/ROOT/pages/extensions/aws-eks.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-eks.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-iam.adoc b/docs/modules/ROOT/pages/extensions/aws-iam.adoc
index a97ec0d..14f21fc 100644
--- a/docs/modules/ROOT/pages/extensions/aws-iam.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-iam.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-kinesis.adoc b/docs/modules/ROOT/pages/extensions/aws-kinesis.adoc
index 75bed03..8ffca08 100644
--- a/docs/modules/ROOT/pages/extensions/aws-kinesis.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-kinesis.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-kms.adoc b/docs/modules/ROOT/pages/extensions/aws-kms.adoc
index be6b691..9e5aa78 100644
--- a/docs/modules/ROOT/pages/extensions/aws-kms.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-kms.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-lambda.adoc b/docs/modules/ROOT/pages/extensions/aws-lambda.adoc
index e52b897..0d1a146 100644
--- a/docs/modules/ROOT/pages/extensions/aws-lambda.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-lambda.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-s3.adoc b/docs/modules/ROOT/pages/extensions/aws-s3.adoc
index 5bbe855..0e5ee45 100644
--- a/docs/modules/ROOT/pages/extensions/aws-s3.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-s3.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-sdb.adoc b/docs/modules/ROOT/pages/extensions/aws-sdb.adoc
index ebe710e..818aa41 100644
--- a/docs/modules/ROOT/pages/extensions/aws-sdb.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-sdb.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-sns.adoc b/docs/modules/ROOT/pages/extensions/aws-sns.adoc
index 5b54677..6425879 100644
--- a/docs/modules/ROOT/pages/extensions/aws-sns.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-sns.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-sqs.adoc b/docs/modules/ROOT/pages/extensions/aws-sqs.adoc
index dfdf41e..166fa5a 100644
--- a/docs/modules/ROOT/pages/extensions/aws-sqs.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-sqs.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-swf.adoc b/docs/modules/ROOT/pages/extensions/aws-swf.adoc
index 693918d..0150061 100644
--- a/docs/modules/ROOT/pages/extensions/aws-swf.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-swf.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws-translate.adoc b/docs/modules/ROOT/pages/extensions/aws-translate.adoc
index fce7487..1aa2cd9 100644
--- a/docs/modules/ROOT/pages/extensions/aws-translate.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws-translate.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-cw.adoc b/docs/modules/ROOT/pages/extensions/aws2-cw.adoc
index d154037..1143e04 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-cw.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-cw.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-ddb.adoc b/docs/modules/ROOT/pages/extensions/aws2-ddb.adoc
index 956d26c..07a23fb 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-ddb.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-ddb.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-ec2.adoc b/docs/modules/ROOT/pages/extensions/aws2-ec2.adoc
index ec3b8d8..9fe922b 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-ec2.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-ec2.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-ecs.adoc b/docs/modules/ROOT/pages/extensions/aws2-ecs.adoc
index 76db4c7..2447d81 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-ecs.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-ecs.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-eks.adoc b/docs/modules/ROOT/pages/extensions/aws2-eks.adoc
index f0471cd..19becc1 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-eks.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-eks.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-iam.adoc b/docs/modules/ROOT/pages/extensions/aws2-iam.adoc
index 0645c0c..468abc2 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-iam.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-iam.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-kms.adoc b/docs/modules/ROOT/pages/extensions/aws2-kms.adoc
index e339eef..ac3d352 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-kms.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-kms.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-mq.adoc b/docs/modules/ROOT/pages/extensions/aws2-mq.adoc
index 5d958fb..ed24878 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-mq.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-mq.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-msk.adoc b/docs/modules/ROOT/pages/extensions/aws2-msk.adoc
index 49cdb14..9e376cd 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-msk.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-msk.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-s3.adoc b/docs/modules/ROOT/pages/extensions/aws2-s3.adoc
index 247d20f..0699417 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-s3.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-s3.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-ses.adoc b/docs/modules/ROOT/pages/extensions/aws2-ses.adoc
index 8690620..ad0fe57 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-ses.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-ses.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-sns.adoc b/docs/modules/ROOT/pages/extensions/aws2-sns.adoc
index 504e4c1..d85a956 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-sns.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-sns.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-sqs.adoc b/docs/modules/ROOT/pages/extensions/aws2-sqs.adoc
index fe0f65c..d8953e3 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-sqs.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-sqs.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/aws2-translate.adoc b/docs/modules/ROOT/pages/extensions/aws2-translate.adoc
index 5cb5de0..fe661b6 100644
--- a/docs/modules/ROOT/pages/extensions/aws2-translate.adoc
+++ b/docs/modules/ROOT/pages/extensions/aws2-translate.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/azure.adoc b/docs/modules/ROOT/pages/extensions/azure.adoc
index 790fb59..d237ccd 100644
--- a/docs/modules/ROOT/pages/extensions/azure.adoc
+++ b/docs/modules/ROOT/pages/extensions/azure.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/base64.adoc b/docs/modules/ROOT/pages/extensions/base64.adoc
index 6ade9a6..88f6f25 100644
--- a/docs/modules/ROOT/pages/extensions/base64.adoc
+++ b/docs/modules/ROOT/pages/extensions/base64.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/bean-validator.adoc b/docs/modules/ROOT/pages/extensions/bean-validator.adoc
index e86c1fa..2ce2f9f 100644
--- a/docs/modules/ROOT/pages/extensions/bean-validator.adoc
+++ b/docs/modules/ROOT/pages/extensions/bean-validator.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/bean.adoc b/docs/modules/ROOT/pages/extensions/bean.adoc
index 6192f3a..9d3ccbd 100644
--- a/docs/modules/ROOT/pages/extensions/bean.adoc
+++ b/docs/modules/ROOT/pages/extensions/bean.adoc
@@ -26,4 +26,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/bindy.adoc b/docs/modules/ROOT/pages/extensions/bindy.adoc
index 6e85037..678edad 100644
--- a/docs/modules/ROOT/pages/extensions/bindy.adoc
+++ b/docs/modules/ROOT/pages/extensions/bindy.adoc
@@ -26,4 +26,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/box.adoc b/docs/modules/ROOT/pages/extensions/box.adoc
index 0be48e5..8d26377 100644
--- a/docs/modules/ROOT/pages/extensions/box.adoc
+++ b/docs/modules/ROOT/pages/extensions/box.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/braintree.adoc b/docs/modules/ROOT/pages/extensions/braintree.adoc
index a812452..d199ce0 100644
--- a/docs/modules/ROOT/pages/extensions/braintree.adoc
+++ b/docs/modules/ROOT/pages/extensions/braintree.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/cassandraql.adoc b/docs/modules/ROOT/pages/extensions/cassandraql.adoc
index 4afd2e0..e46f69f 100644
--- a/docs/modules/ROOT/pages/extensions/cassandraql.adoc
+++ b/docs/modules/ROOT/pages/extensions/cassandraql.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/consul.adoc b/docs/modules/ROOT/pages/extensions/consul.adoc
index 55a2acf..25ea4c0 100644
--- a/docs/modules/ROOT/pages/extensions/consul.adoc
+++ b/docs/modules/ROOT/pages/extensions/consul.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/controlbus.adoc b/docs/modules/ROOT/pages/extensions/controlbus.adoc
index 7dc63be..4eacc3d 100644
--- a/docs/modules/ROOT/pages/extensions/controlbus.adoc
+++ b/docs/modules/ROOT/pages/extensions/controlbus.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/core-cloud.adoc b/docs/modules/ROOT/pages/extensions/core-cloud.adoc
index 200aa24..39abca9 100644
--- a/docs/modules/ROOT/pages/extensions/core-cloud.adoc
+++ b/docs/modules/ROOT/pages/extensions/core-cloud.adoc
@@ -18,4 +18,4 @@ The Camel Quarkus core cloud module
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/core.adoc b/docs/modules/ROOT/pages/extensions/core.adoc
index 2093438..140e92b 100644
--- a/docs/modules/ROOT/pages/extensions/core.adoc
+++ b/docs/modules/ROOT/pages/extensions/core.adoc
@@ -30,4 +30,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/couchbase.adoc b/docs/modules/ROOT/pages/extensions/couchbase.adoc
index 9b86d4b..a7753ee 100644
--- a/docs/modules/ROOT/pages/extensions/couchbase.adoc
+++ b/docs/modules/ROOT/pages/extensions/couchbase.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/couchdb.adoc b/docs/modules/ROOT/pages/extensions/couchdb.adoc
index ccfa1c7..20e5721 100644
--- a/docs/modules/ROOT/pages/extensions/couchdb.adoc
+++ b/docs/modules/ROOT/pages/extensions/couchdb.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Camel Quarkus limitations
 
diff --git a/docs/modules/ROOT/pages/extensions/cron.adoc b/docs/modules/ROOT/pages/extensions/cron.adoc
index 2429347..383a26a 100644
--- a/docs/modules/ROOT/pages/extensions/cron.adoc
+++ b/docs/modules/ROOT/pages/extensions/cron.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/csv.adoc b/docs/modules/ROOT/pages/extensions/csv.adoc
index 68a2b92..8f93eda 100644
--- a/docs/modules/ROOT/pages/extensions/csv.adoc
+++ b/docs/modules/ROOT/pages/extensions/csv.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/dataformat.adoc b/docs/modules/ROOT/pages/extensions/dataformat.adoc
index 9b430f4..4a7f96e 100644
--- a/docs/modules/ROOT/pages/extensions/dataformat.adoc
+++ b/docs/modules/ROOT/pages/extensions/dataformat.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/debezium-mongodb.adoc b/docs/modules/ROOT/pages/extensions/debezium-mongodb.adoc
index e15fbde..68be288 100644
--- a/docs/modules/ROOT/pages/extensions/debezium-mongodb.adoc
+++ b/docs/modules/ROOT/pages/extensions/debezium-mongodb.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/debezium-mysql.adoc b/docs/modules/ROOT/pages/extensions/debezium-mysql.adoc
index fa35fa7..533e6da 100644
--- a/docs/modules/ROOT/pages/extensions/debezium-mysql.adoc
+++ b/docs/modules/ROOT/pages/extensions/debezium-mysql.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/debezium-postgres.adoc b/docs/modules/ROOT/pages/extensions/debezium-postgres.adoc
index b3194ed..69d6b7d 100644
--- a/docs/modules/ROOT/pages/extensions/debezium-postgres.adoc
+++ b/docs/modules/ROOT/pages/extensions/debezium-postgres.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Camel Quarkus limitations
 
diff --git a/docs/modules/ROOT/pages/extensions/debezium-sqlserver.adoc b/docs/modules/ROOT/pages/extensions/debezium-sqlserver.adoc
index 146aeab..440a307 100644
--- a/docs/modules/ROOT/pages/extensions/debezium-sqlserver.adoc
+++ b/docs/modules/ROOT/pages/extensions/debezium-sqlserver.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/direct.adoc b/docs/modules/ROOT/pages/extensions/direct.adoc
index b1c1d51..487960f 100644
--- a/docs/modules/ROOT/pages/extensions/direct.adoc
+++ b/docs/modules/ROOT/pages/extensions/direct.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/dozer.adoc b/docs/modules/ROOT/pages/extensions/dozer.adoc
index 18f0aa2..697a4e4 100644
--- a/docs/modules/ROOT/pages/extensions/dozer.adoc
+++ b/docs/modules/ROOT/pages/extensions/dozer.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
diff --git a/docs/modules/ROOT/pages/extensions/elasticsearch-rest.adoc b/docs/modules/ROOT/pages/extensions/elasticsearch-rest.adoc
index 7a43fbc..2576648 100644
--- a/docs/modules/ROOT/pages/extensions/elasticsearch-rest.adoc
+++ b/docs/modules/ROOT/pages/extensions/elasticsearch-rest.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/endpointdsl.adoc b/docs/modules/ROOT/pages/extensions/endpointdsl.adoc
index 4f38dbc..56196ea 100644
--- a/docs/modules/ROOT/pages/extensions/endpointdsl.adoc
+++ b/docs/modules/ROOT/pages/extensions/endpointdsl.adoc
@@ -18,4 +18,4 @@ Code Camel endpoint URI using Java DSL instead of plain strings
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/exec.adoc b/docs/modules/ROOT/pages/extensions/exec.adoc
index 3bb212d..4dbfe2e 100644
--- a/docs/modules/ROOT/pages/extensions/exec.adoc
+++ b/docs/modules/ROOT/pages/extensions/exec.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/fhir.adoc b/docs/modules/ROOT/pages/extensions/fhir.adoc
index 00cd9b4..18f9bdb 100644
--- a/docs/modules/ROOT/pages/extensions/fhir.adoc
+++ b/docs/modules/ROOT/pages/extensions/fhir.adoc
@@ -26,7 +26,7 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
diff --git a/docs/modules/ROOT/pages/extensions/file-watch.adoc b/docs/modules/ROOT/pages/extensions/file-watch.adoc
index 9a0cd7d..7a12488 100644
--- a/docs/modules/ROOT/pages/extensions/file-watch.adoc
+++ b/docs/modules/ROOT/pages/extensions/file-watch.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Camel Quarkus limitations
 
diff --git a/docs/modules/ROOT/pages/extensions/file.adoc b/docs/modules/ROOT/pages/extensions/file.adoc
index 2033f95..5e2c18a 100644
--- a/docs/modules/ROOT/pages/extensions/file.adoc
+++ b/docs/modules/ROOT/pages/extensions/file.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/ftp.adoc b/docs/modules/ROOT/pages/extensions/ftp.adoc
index d62afcb..de46516 100644
--- a/docs/modules/ROOT/pages/extensions/ftp.adoc
+++ b/docs/modules/ROOT/pages/extensions/ftp.adoc
@@ -26,4 +26,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/github.adoc b/docs/modules/ROOT/pages/extensions/github.adoc
index a490a3a..ae31448 100644
--- a/docs/modules/ROOT/pages/extensions/github.adoc
+++ b/docs/modules/ROOT/pages/extensions/github.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/google-bigquery.adoc b/docs/modules/ROOT/pages/extensions/google-bigquery.adoc
index cc22602..f79d8ab 100644
--- a/docs/modules/ROOT/pages/extensions/google-bigquery.adoc
+++ b/docs/modules/ROOT/pages/extensions/google-bigquery.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/google-calendar.adoc b/docs/modules/ROOT/pages/extensions/google-calendar.adoc
index 6bb0aac..6d158f4 100644
--- a/docs/modules/ROOT/pages/extensions/google-calendar.adoc
+++ b/docs/modules/ROOT/pages/extensions/google-calendar.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/google-drive.adoc b/docs/modules/ROOT/pages/extensions/google-drive.adoc
index ccf2495..1520946 100644
--- a/docs/modules/ROOT/pages/extensions/google-drive.adoc
+++ b/docs/modules/ROOT/pages/extensions/google-drive.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/google-mail.adoc b/docs/modules/ROOT/pages/extensions/google-mail.adoc
index 8642bd8..706849d 100644
--- a/docs/modules/ROOT/pages/extensions/google-mail.adoc
+++ b/docs/modules/ROOT/pages/extensions/google-mail.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/google-pubsub.adoc b/docs/modules/ROOT/pages/extensions/google-pubsub.adoc
index 7a1d497..5138630 100644
--- a/docs/modules/ROOT/pages/extensions/google-pubsub.adoc
+++ b/docs/modules/ROOT/pages/extensions/google-pubsub.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/google-sheets.adoc b/docs/modules/ROOT/pages/extensions/google-sheets.adoc
index 94ae592..201e6eb 100644
--- a/docs/modules/ROOT/pages/extensions/google-sheets.adoc
+++ b/docs/modules/ROOT/pages/extensions/google-sheets.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/graphql.adoc b/docs/modules/ROOT/pages/extensions/graphql.adoc
index 8290e37..c3d696a 100644
--- a/docs/modules/ROOT/pages/extensions/graphql.adoc
+++ b/docs/modules/ROOT/pages/extensions/graphql.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
diff --git a/docs/modules/ROOT/pages/extensions/groovy.adoc b/docs/modules/ROOT/pages/extensions/groovy.adoc
index 561d516..7deee46 100644
--- a/docs/modules/ROOT/pages/extensions/groovy.adoc
+++ b/docs/modules/ROOT/pages/extensions/groovy.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/grpc.adoc b/docs/modules/ROOT/pages/extensions/grpc.adoc
index 88a1b7a..aa50c1e 100644
--- a/docs/modules/ROOT/pages/extensions/grpc.adoc
+++ b/docs/modules/ROOT/pages/extensions/grpc.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/gson.adoc b/docs/modules/ROOT/pages/extensions/gson.adoc
index b0b67c5..c1c69d0 100644
--- a/docs/modules/ROOT/pages/extensions/gson.adoc
+++ b/docs/modules/ROOT/pages/extensions/gson.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/http.adoc b/docs/modules/ROOT/pages/extensions/http.adoc
index a94a71e..cbbd3fb 100644
--- a/docs/modules/ROOT/pages/extensions/http.adoc
+++ b/docs/modules/ROOT/pages/extensions/http.adoc
@@ -25,10 +25,10 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
   your application to send or receive requests using non-default encodings.
 
diff --git a/docs/modules/ROOT/pages/extensions/hystrix.adoc b/docs/modules/ROOT/pages/extensions/hystrix.adoc
index 81c4fc9..d7a8cea 100644
--- a/docs/modules/ROOT/pages/extensions/hystrix.adoc
+++ b/docs/modules/ROOT/pages/extensions/hystrix.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/ical.adoc b/docs/modules/ROOT/pages/extensions/ical.adoc
index 39a3d90..7f3dc5d 100644
--- a/docs/modules/ROOT/pages/extensions/ical.adoc
+++ b/docs/modules/ROOT/pages/extensions/ical.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/infinispan.adoc b/docs/modules/ROOT/pages/extensions/infinispan.adoc
index b1d595b..5c20c70 100644
--- a/docs/modules/ROOT/pages/extensions/infinispan.adoc
+++ b/docs/modules/ROOT/pages/extensions/infinispan.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/influxdb.adoc b/docs/modules/ROOT/pages/extensions/influxdb.adoc
index 5e4a1c2..89c560c 100644
--- a/docs/modules/ROOT/pages/extensions/influxdb.adoc
+++ b/docs/modules/ROOT/pages/extensions/influxdb.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/jackson.adoc b/docs/modules/ROOT/pages/extensions/jackson.adoc
index 918c2cb..ee96d41 100644
--- a/docs/modules/ROOT/pages/extensions/jackson.adoc
+++ b/docs/modules/ROOT/pages/extensions/jackson.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/jacksonxml.adoc b/docs/modules/ROOT/pages/extensions/jacksonxml.adoc
index 6deff0e..8a096d1 100644
--- a/docs/modules/ROOT/pages/extensions/jacksonxml.adoc
+++ b/docs/modules/ROOT/pages/extensions/jacksonxml.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/jaxb.adoc b/docs/modules/ROOT/pages/extensions/jaxb.adoc
index 7dde0e0..62d5f22 100644
--- a/docs/modules/ROOT/pages/extensions/jaxb.adoc
+++ b/docs/modules/ROOT/pages/extensions/jaxb.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/jdbc.adoc b/docs/modules/ROOT/pages/extensions/jdbc.adoc
index 6f2a23a..f84286f 100644
--- a/docs/modules/ROOT/pages/extensions/jdbc.adoc
+++ b/docs/modules/ROOT/pages/extensions/jdbc.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/jira.adoc b/docs/modules/ROOT/pages/extensions/jira.adoc
index c6b1e10..202070e 100644
--- a/docs/modules/ROOT/pages/extensions/jira.adoc
+++ b/docs/modules/ROOT/pages/extensions/jira.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/jms.adoc b/docs/modules/ROOT/pages/extensions/jms.adoc
index da9435c..0a468ec 100644
--- a/docs/modules/ROOT/pages/extensions/jms.adoc
+++ b/docs/modules/ROOT/pages/extensions/jms.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/johnzon.adoc b/docs/modules/ROOT/pages/extensions/johnzon.adoc
index 97ca5fa..a145b08 100644
--- a/docs/modules/ROOT/pages/extensions/johnzon.adoc
+++ b/docs/modules/ROOT/pages/extensions/johnzon.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/jsonpath.adoc b/docs/modules/ROOT/pages/extensions/jsonpath.adoc
index 6e5af8e..800d879 100644
--- a/docs/modules/ROOT/pages/extensions/jsonpath.adoc
+++ b/docs/modules/ROOT/pages/extensions/jsonpath.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/kafka.adoc b/docs/modules/ROOT/pages/extensions/kafka.adoc
index 4d83b46..064920a 100644
--- a/docs/modules/ROOT/pages/extensions/kafka.adoc
+++ b/docs/modules/ROOT/pages/extensions/kafka.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/kotlin.adoc b/docs/modules/ROOT/pages/extensions/kotlin.adoc
index 758084e..82e4ba3 100644
--- a/docs/modules/ROOT/pages/extensions/kotlin.adoc
+++ b/docs/modules/ROOT/pages/extensions/kotlin.adoc
@@ -18,4 +18,4 @@ Write Camel integration routes in Kotlin
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/kubernetes.adoc b/docs/modules/ROOT/pages/extensions/kubernetes.adoc
index 61eca97..664707f 100644
--- a/docs/modules/ROOT/pages/extensions/kubernetes.adoc
+++ b/docs/modules/ROOT/pages/extensions/kubernetes.adoc
@@ -39,4 +39,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/kudu.adoc b/docs/modules/ROOT/pages/extensions/kudu.adoc
index 52a67fc..3598038 100644
--- a/docs/modules/ROOT/pages/extensions/kudu.adoc
+++ b/docs/modules/ROOT/pages/extensions/kudu.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/log.adoc b/docs/modules/ROOT/pages/extensions/log.adoc
index 6408f8e..09472a5 100644
--- a/docs/modules/ROOT/pages/extensions/log.adoc
+++ b/docs/modules/ROOT/pages/extensions/log.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/lzf.adoc b/docs/modules/ROOT/pages/extensions/lzf.adoc
index b20f1b6..ab3f983 100644
--- a/docs/modules/ROOT/pages/extensions/lzf.adoc
+++ b/docs/modules/ROOT/pages/extensions/lzf.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/mail.adoc b/docs/modules/ROOT/pages/extensions/mail.adoc
index 0d67be3..528a2fc 100644
--- a/docs/modules/ROOT/pages/extensions/mail.adoc
+++ b/docs/modules/ROOT/pages/extensions/mail.adoc
@@ -30,4 +30,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/microprofile-health.adoc b/docs/modules/ROOT/pages/extensions/microprofile-health.adoc
index 0ec1f2b..54be12a 100644
--- a/docs/modules/ROOT/pages/extensions/microprofile-health.adoc
+++ b/docs/modules/ROOT/pages/extensions/microprofile-health.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Usage
 
diff --git a/docs/modules/ROOT/pages/extensions/microprofile-metrics.adoc b/docs/modules/ROOT/pages/extensions/microprofile-metrics.adoc
index d0d3eb4..9b6209c 100644
--- a/docs/modules/ROOT/pages/extensions/microprofile-metrics.adoc
+++ b/docs/modules/ROOT/pages/extensions/microprofile-metrics.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Usage
 
diff --git a/docs/modules/ROOT/pages/extensions/mongodb-gridfs.adoc b/docs/modules/ROOT/pages/extensions/mongodb-gridfs.adoc
index 882ee1d..09bf928 100644
--- a/docs/modules/ROOT/pages/extensions/mongodb-gridfs.adoc
+++ b/docs/modules/ROOT/pages/extensions/mongodb-gridfs.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/mongodb.adoc b/docs/modules/ROOT/pages/extensions/mongodb.adoc
index 3f6b7b4..fdf79cb 100644
--- a/docs/modules/ROOT/pages/extensions/mongodb.adoc
+++ b/docs/modules/ROOT/pages/extensions/mongodb.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
diff --git a/docs/modules/ROOT/pages/extensions/mustache.adoc b/docs/modules/ROOT/pages/extensions/mustache.adoc
index 3a1d06f..574add9 100644
--- a/docs/modules/ROOT/pages/extensions/mustache.adoc
+++ b/docs/modules/ROOT/pages/extensions/mustache.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
@@ -42,5 +42,5 @@ In order to work in native mode the `include-patterns` configuration should be s
 quarkus.camel.native.resources.include-patterns = template/*.mustache
 ----
 
-More information about selecting resources for inclusion in the native executable could be found at xref:native-mode.adoc#embedding-resource-in-native-executable[Embedding resource in native executable].
+More information about selecting resources for inclusion in the native executable could be found at xref:user-guide/native-mode.adoc#embedding-resource-in-native-executable[Embedding resource in native executable].
 
diff --git a/docs/modules/ROOT/pages/extensions/netty-http.adoc b/docs/modules/ROOT/pages/extensions/netty-http.adoc
index eecad53..7c614d7 100644
--- a/docs/modules/ROOT/pages/extensions/netty-http.adoc
+++ b/docs/modules/ROOT/pages/extensions/netty-http.adoc
@@ -25,10 +25,10 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
   your application to send or receive requests using non-default encodings.
 
diff --git a/docs/modules/ROOT/pages/extensions/netty.adoc b/docs/modules/ROOT/pages/extensions/netty.adoc
index 42f12da..f296cfb 100644
--- a/docs/modules/ROOT/pages/extensions/netty.adoc
+++ b/docs/modules/ROOT/pages/extensions/netty.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/nitrite.adoc b/docs/modules/ROOT/pages/extensions/nitrite.adoc
index 3414f9e..cd1ef93 100644
--- a/docs/modules/ROOT/pages/extensions/nitrite.adoc
+++ b/docs/modules/ROOT/pages/extensions/nitrite.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/ognl.adoc b/docs/modules/ROOT/pages/extensions/ognl.adoc
index 957115f..23e48e1 100644
--- a/docs/modules/ROOT/pages/extensions/ognl.adoc
+++ b/docs/modules/ROOT/pages/extensions/ognl.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/olingo4.adoc b/docs/modules/ROOT/pages/extensions/olingo4.adoc
index ce0054a..911cd6e 100644
--- a/docs/modules/ROOT/pages/extensions/olingo4.adoc
+++ b/docs/modules/ROOT/pages/extensions/olingo4.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/openstack.adoc b/docs/modules/ROOT/pages/extensions/openstack.adoc
index 1edca23..987a5c2 100644
--- a/docs/modules/ROOT/pages/extensions/openstack.adoc
+++ b/docs/modules/ROOT/pages/extensions/openstack.adoc
@@ -29,4 +29,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/opentracing.adoc b/docs/modules/ROOT/pages/extensions/opentracing.adoc
index e56489e..c548633 100644
--- a/docs/modules/ROOT/pages/extensions/opentracing.adoc
+++ b/docs/modules/ROOT/pages/extensions/opentracing.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Usage
 
diff --git a/docs/modules/ROOT/pages/extensions/paho.adoc b/docs/modules/ROOT/pages/extensions/paho.adoc
index 0d79d8e..117c888 100644
--- a/docs/modules/ROOT/pages/extensions/paho.adoc
+++ b/docs/modules/ROOT/pages/extensions/paho.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/pdf.adoc b/docs/modules/ROOT/pages/extensions/pdf.adoc
index 34fa1a6..ffd7c36 100644
--- a/docs/modules/ROOT/pages/extensions/pdf.adoc
+++ b/docs/modules/ROOT/pages/extensions/pdf.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/platform-http.adoc b/docs/modules/ROOT/pages/extensions/platform-http.adoc
index 7c0f37e..dce02a1 100644
--- a/docs/modules/ROOT/pages/extensions/platform-http.adoc
+++ b/docs/modules/ROOT/pages/extensions/platform-http.adoc
@@ -27,7 +27,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Usage
 
@@ -114,6 +114,6 @@ https://quarkus.io/guides/all-config[Quarkus documentation], esp. `quarkus.http.
 
 == Additional Camel Quarkus configuration
 
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
   your application to send or receive requests using non-default encodings.
 
diff --git a/docs/modules/ROOT/pages/extensions/protobuf.adoc b/docs/modules/ROOT/pages/extensions/protobuf.adoc
index 6d6764a..bd4e497 100644
--- a/docs/modules/ROOT/pages/extensions/protobuf.adoc
+++ b/docs/modules/ROOT/pages/extensions/protobuf.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/pubnub.adoc b/docs/modules/ROOT/pages/extensions/pubnub.adoc
index b6fa64a..37c0be6 100644
--- a/docs/modules/ROOT/pages/extensions/pubnub.adoc
+++ b/docs/modules/ROOT/pages/extensions/pubnub.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/quartz.adoc b/docs/modules/ROOT/pages/extensions/quartz.adoc
index 40db938..057fb5d 100644
--- a/docs/modules/ROOT/pages/extensions/quartz.adoc
+++ b/docs/modules/ROOT/pages/extensions/quartz.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/qute.adoc b/docs/modules/ROOT/pages/extensions/qute.adoc
index 68840ac..2c88a2c 100644
--- a/docs/modules/ROOT/pages/extensions/qute.adoc
+++ b/docs/modules/ROOT/pages/extensions/qute.adoc
@@ -18,7 +18,7 @@ Transform messages using Quarkus Qute templating engine
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Usage
 
diff --git a/docs/modules/ROOT/pages/extensions/rabbitmq.adoc b/docs/modules/ROOT/pages/extensions/rabbitmq.adoc
index 9f0a95a..bc1958d 100644
--- a/docs/modules/ROOT/pages/extensions/rabbitmq.adoc
+++ b/docs/modules/ROOT/pages/extensions/rabbitmq.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/reactive-executor.adoc b/docs/modules/ROOT/pages/extensions/reactive-executor.adoc
index 55440b8..2f07901 100644
--- a/docs/modules/ROOT/pages/extensions/reactive-executor.adoc
+++ b/docs/modules/ROOT/pages/extensions/reactive-executor.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/reactive-streams.adoc b/docs/modules/ROOT/pages/extensions/reactive-streams.adoc
index 281b410..8b6df24 100644
--- a/docs/modules/ROOT/pages/extensions/reactive-streams.adoc
+++ b/docs/modules/ROOT/pages/extensions/reactive-streams.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/ref.adoc b/docs/modules/ROOT/pages/extensions/ref.adoc
index 7d0dd65..80bd25e 100644
--- a/docs/modules/ROOT/pages/extensions/ref.adoc
+++ b/docs/modules/ROOT/pages/extensions/ref.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/rest-openapi.adoc b/docs/modules/ROOT/pages/extensions/rest-openapi.adoc
index a9b89b0..7265f26 100644
--- a/docs/modules/ROOT/pages/extensions/rest-openapi.adoc
+++ b/docs/modules/ROOT/pages/extensions/rest-openapi.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/rest.adoc b/docs/modules/ROOT/pages/extensions/rest.adoc
index 1d1548e..606f215 100644
--- a/docs/modules/ROOT/pages/extensions/rest.adoc
+++ b/docs/modules/ROOT/pages/extensions/rest.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/salesforce.adoc b/docs/modules/ROOT/pages/extensions/salesforce.adoc
index f2dfc3b..b461b44 100644
--- a/docs/modules/ROOT/pages/extensions/salesforce.adoc
+++ b/docs/modules/ROOT/pages/extensions/salesforce.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/sap-netweaver.adoc b/docs/modules/ROOT/pages/extensions/sap-netweaver.adoc
index 65167ab..416cd7e 100644
--- a/docs/modules/ROOT/pages/extensions/sap-netweaver.adoc
+++ b/docs/modules/ROOT/pages/extensions/sap-netweaver.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/scheduler.adoc b/docs/modules/ROOT/pages/extensions/scheduler.adoc
index 174d28c..02e00df 100644
--- a/docs/modules/ROOT/pages/extensions/scheduler.adoc
+++ b/docs/modules/ROOT/pages/extensions/scheduler.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/seda.adoc b/docs/modules/ROOT/pages/extensions/seda.adoc
index 6115bfc..5a30ee2 100644
--- a/docs/modules/ROOT/pages/extensions/seda.adoc
+++ b/docs/modules/ROOT/pages/extensions/seda.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/servicenow.adoc b/docs/modules/ROOT/pages/extensions/servicenow.adoc
index ebb4a60..47e2021 100644
--- a/docs/modules/ROOT/pages/extensions/servicenow.adoc
+++ b/docs/modules/ROOT/pages/extensions/servicenow.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/servlet.adoc b/docs/modules/ROOT/pages/extensions/servlet.adoc
index 7b01706..500800a 100644
--- a/docs/modules/ROOT/pages/extensions/servlet.adoc
+++ b/docs/modules/ROOT/pages/extensions/servlet.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/sjms.adoc b/docs/modules/ROOT/pages/extensions/sjms.adoc
index d8d2d96..fb30d3c 100644
--- a/docs/modules/ROOT/pages/extensions/sjms.adoc
+++ b/docs/modules/ROOT/pages/extensions/sjms.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/sjms2.adoc b/docs/modules/ROOT/pages/extensions/sjms2.adoc
index a241090..ffe6455 100644
--- a/docs/modules/ROOT/pages/extensions/sjms2.adoc
+++ b/docs/modules/ROOT/pages/extensions/sjms2.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/slack.adoc b/docs/modules/ROOT/pages/extensions/slack.adoc
index 3c83de3..e5842b4 100644
--- a/docs/modules/ROOT/pages/extensions/slack.adoc
+++ b/docs/modules/ROOT/pages/extensions/slack.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/snakeyaml.adoc b/docs/modules/ROOT/pages/extensions/snakeyaml.adoc
index 1a0f199..6001945 100644
--- a/docs/modules/ROOT/pages/extensions/snakeyaml.adoc
+++ b/docs/modules/ROOT/pages/extensions/snakeyaml.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/soap.adoc b/docs/modules/ROOT/pages/extensions/soap.adoc
index 5927c34..faa4a05 100644
--- a/docs/modules/ROOT/pages/extensions/soap.adoc
+++ b/docs/modules/ROOT/pages/extensions/soap.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/sql.adoc b/docs/modules/ROOT/pages/extensions/sql.adoc
index f380a11..7854b61 100644
--- a/docs/modules/ROOT/pages/extensions/sql.adoc
+++ b/docs/modules/ROOT/pages/extensions/sql.adoc
@@ -25,7 +25,7 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
diff --git a/docs/modules/ROOT/pages/extensions/stream.adoc b/docs/modules/ROOT/pages/extensions/stream.adoc
index d778313..c047d83 100644
--- a/docs/modules/ROOT/pages/extensions/stream.adoc
+++ b/docs/modules/ROOT/pages/extensions/stream.adoc
@@ -24,10 +24,10 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you want to use
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you want to use
  non-default encodings for the stream endpoint `encoding` URI parameter.
 
diff --git a/docs/modules/ROOT/pages/extensions/tagsoup.adoc b/docs/modules/ROOT/pages/extensions/tagsoup.adoc
index b842d0c..c069601 100644
--- a/docs/modules/ROOT/pages/extensions/tagsoup.adoc
+++ b/docs/modules/ROOT/pages/extensions/tagsoup.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/tarfile.adoc b/docs/modules/ROOT/pages/extensions/tarfile.adoc
index b03332d..6ea6543 100644
--- a/docs/modules/ROOT/pages/extensions/tarfile.adoc
+++ b/docs/modules/ROOT/pages/extensions/tarfile.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/telegram.adoc b/docs/modules/ROOT/pages/extensions/telegram.adoc
index 212e600..43342dc 100644
--- a/docs/modules/ROOT/pages/extensions/telegram.adoc
+++ b/docs/modules/ROOT/pages/extensions/telegram.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/timer.adoc b/docs/modules/ROOT/pages/extensions/timer.adoc
index 2a2b622..7623073 100644
--- a/docs/modules/ROOT/pages/extensions/timer.adoc
+++ b/docs/modules/ROOT/pages/extensions/timer.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/twitter.adoc b/docs/modules/ROOT/pages/extensions/twitter.adoc
index 25d9c68..49cc476 100644
--- a/docs/modules/ROOT/pages/extensions/twitter.adoc
+++ b/docs/modules/ROOT/pages/extensions/twitter.adoc
@@ -26,4 +26,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/validator.adoc b/docs/modules/ROOT/pages/extensions/validator.adoc
index edb102c..63e02d4 100644
--- a/docs/modules/ROOT/pages/extensions/validator.adoc
+++ b/docs/modules/ROOT/pages/extensions/validator.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/vm.adoc b/docs/modules/ROOT/pages/extensions/vm.adoc
index 49b5215..fa45bde 100644
--- a/docs/modules/ROOT/pages/extensions/vm.adoc
+++ b/docs/modules/ROOT/pages/extensions/vm.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/websocket-jsr356.adoc b/docs/modules/ROOT/pages/extensions/websocket-jsr356.adoc
index 25109f3..ce41b6e 100644
--- a/docs/modules/ROOT/pages/extensions/websocket-jsr356.adoc
+++ b/docs/modules/ROOT/pages/extensions/websocket-jsr356.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
diff --git a/docs/modules/ROOT/pages/extensions/xml-io.adoc b/docs/modules/ROOT/pages/extensions/xml-io.adoc
index 113c952..d837dd3 100644
--- a/docs/modules/ROOT/pages/extensions/xml-io.adoc
+++ b/docs/modules/ROOT/pages/extensions/xml-io.adoc
@@ -18,4 +18,4 @@ An XML stack for parsing XML route definitions. A fast an light weight alternati
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/xml-jaxb.adoc b/docs/modules/ROOT/pages/extensions/xml-jaxb.adoc
index 099a662..e53241c 100644
--- a/docs/modules/ROOT/pages/extensions/xml-jaxb.adoc
+++ b/docs/modules/ROOT/pages/extensions/xml-jaxb.adoc
@@ -18,4 +18,4 @@ An XML stack for parsing XML route definitions. A legacy alternative to the fast
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/xml-jaxp.adoc b/docs/modules/ROOT/pages/extensions/xml-jaxp.adoc
index 9a7eec3..2a0c9e7 100644
--- a/docs/modules/ROOT/pages/extensions/xml-jaxp.adoc
+++ b/docs/modules/ROOT/pages/extensions/xml-jaxp.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/xpath.adoc b/docs/modules/ROOT/pages/extensions/xpath.adoc
index 21e0801..376c2f1 100644
--- a/docs/modules/ROOT/pages/extensions/xpath.adoc
+++ b/docs/modules/ROOT/pages/extensions/xpath.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/xslt.adoc b/docs/modules/ROOT/pages/extensions/xslt.adoc
index ff4a1bb..543ddeb 100644
--- a/docs/modules/ROOT/pages/extensions/xslt.adoc
+++ b/docs/modules/ROOT/pages/extensions/xslt.adoc
@@ -24,7 +24,7 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 
 == Additional Camel Quarkus configuration
 
diff --git a/docs/modules/ROOT/pages/extensions/xstream.adoc b/docs/modules/ROOT/pages/extensions/xstream.adoc
index 6292d3e..c3881bd 100644
--- a/docs/modules/ROOT/pages/extensions/xstream.adoc
+++ b/docs/modules/ROOT/pages/extensions/xstream.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/zip-deflater.adoc b/docs/modules/ROOT/pages/extensions/zip-deflater.adoc
index e2d2fa7..29b2b42 100644
--- a/docs/modules/ROOT/pages/extensions/zip-deflater.adoc
+++ b/docs/modules/ROOT/pages/extensions/zip-deflater.adoc
@@ -25,4 +25,4 @@ Please refer to the above links for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/extensions/zipfile.adoc b/docs/modules/ROOT/pages/extensions/zipfile.adoc
index 03bf4cf..4cd997d 100644
--- a/docs/modules/ROOT/pages/extensions/zipfile.adoc
+++ b/docs/modules/ROOT/pages/extensions/zipfile.adoc
@@ -24,4 +24,4 @@ Please refer to the above link for usage and configuration details.
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
diff --git a/docs/modules/ROOT/pages/list-of-camel-quarkus-extensions.adoc b/docs/modules/ROOT/pages/list-of-camel-quarkus-extensions.adoc
index 1164c50..635dfca 100644
--- a/docs/modules/ROOT/pages/list-of-camel-quarkus-extensions.adoc
+++ b/docs/modules/ROOT/pages/list-of-camel-quarkus-extensions.adoc
@@ -9,7 +9,7 @@ In case you are missing some Camel feature in the list:
 
 * Upvote https://github.com/apache/camel-quarkus/issues[an existing issue] or create
   https://github.com/apache/camel-quarkus/issues/new[a new one] so that we can better prioritize our work.
-* You may also want to try to add the extension yourself following our xref:contributor-guide.adoc[Contributor guide].
+* You may also want to try to add the extension yourself following our xref:contributor-guide/index.adoc[Contributor guide].
 * You may try your luck using the given camel component on Quarkus directly (without an extension). Most probably it
   will work in the JVM mode and fail in the native mode. Do not hesitate to
   https://github.com/apache/camel-quarkus/issues[report] any issues you encounter.
diff --git a/docs/modules/ROOT/pages/cdi.adoc b/docs/modules/ROOT/pages/user-guide/cdi.adoc
similarity index 97%
rename from docs/modules/ROOT/pages/cdi.adoc
rename to docs/modules/ROOT/pages/user-guide/cdi.adoc
index 3d1680a..15ed003 100644
--- a/docs/modules/ROOT/pages/cdi.adoc
+++ b/docs/modules/ROOT/pages/user-guide/cdi.adoc
@@ -1,9 +1,10 @@
 = Contexts and Dependency Injection (CDI) in Camel Quarkus
+:page-aliases: cdi.adoc
 
 CDI plays a central role in Quarkus and Camel Quarkus offers a first class support for it too.
 
 You may use `@Inject`, `@ConfigProperty` and similar annotations e.g. to inject beans and configuration values to
-your Camel `RouteBuilder`s. Here is the `RouteBuilder` from our `timer-log-cdi` xref:examples.adoc[example]:
+your Camel `RouteBuilder`s. Here is the `RouteBuilder` from our `timer-log-cdi` xref:user-guide/examples.adoc[example]:
 
 [source,java]
 ----
diff --git a/docs/modules/ROOT/pages/examples.adoc b/docs/modules/ROOT/pages/user-guide/examples.adoc
similarity index 90%
rename from docs/modules/ROOT/pages/examples.adoc
rename to docs/modules/ROOT/pages/user-guide/examples.adoc
index 8279723..d18d34d 100644
--- a/docs/modules/ROOT/pages/examples.adoc
+++ b/docs/modules/ROOT/pages/user-guide/examples.adoc
@@ -1,14 +1,15 @@
 = Camel Quarkus Examples
+:page-aliases: examples.adoc
 
 We offer several examples in our https://github.com/apache/camel-quarkus/tree/master/examples[source tree]. To learn
-how to use them, please follow the xref:first-steps.adoc[First steps] chapter of the User guide.
+how to use them, please follow the xref:user-guide/first-steps.adoc[First steps] chapter of the User guide.
 
 // examples: START
 Number of Examples: 8 (0 deprecated)
 [width="100%",cols="3,7",options="header"]
 |===
 | Example | Description
-| link:https://github.com/apache/camel-quarkus/tree/master/examples/observability/README.adoc[Observability] (observability) | An example that demonstrates how to add support for metrics, health checks and distributed tracing
+| link:https://github.com/apache/camel-quarkus/tree/master/examples/observability/README.adoc[Observability] (observability) | An example that demonstrates how to add support for metrics, health checks and distributed tracing
 | link:https://github.com/apache/camel-quarkus/tree/master/examples/rest-json/README.adoc[Rest Json] (rest-json) | This example is a port of Quarkus' quickstart to Camel
 | link:https://github.com/apache/camel-quarkus/tree/master/examples/timer-log/README.adoc[Timer Log] (timer-log) | An example of basic Hello World that uses a Camel timer
 | link:https://github.com/apache/camel-quarkus/tree/master/examples/timer-log-cdi/README.adoc[Timer Log CDI] (timer-log-cdi) | An example of basic Hello World that uses CDI to set-up a Camel timer
diff --git a/docs/modules/ROOT/pages/first-steps.adoc b/docs/modules/ROOT/pages/user-guide/first-steps.adoc
similarity index 99%
rename from docs/modules/ROOT/pages/first-steps.adoc
rename to docs/modules/ROOT/pages/user-guide/first-steps.adoc
index 1ce46e2..0065d18 100644
--- a/docs/modules/ROOT/pages/first-steps.adoc
+++ b/docs/modules/ROOT/pages/user-guide/first-steps.adoc
@@ -1,4 +1,5 @@
 = First steps
+:page-aliases: first-steps.adoc
 
 We recommend you to choose an example from our https://github.com/apache/camel-quarkus/tree/master/examples[source tree]
 as a base for your real world project.
diff --git a/docs/modules/ROOT/pages/user-guide.adoc b/docs/modules/ROOT/pages/user-guide/index.adoc
similarity index 81%
rename from docs/modules/ROOT/pages/user-guide.adoc
rename to docs/modules/ROOT/pages/user-guide/index.adoc
index 2a1ee9f..9989686 100644
--- a/docs/modules/ROOT/pages/user-guide.adoc
+++ b/docs/modules/ROOT/pages/user-guide/index.adoc
@@ -1,5 +1,6 @@
 [[user-guide]]
 = User guide
+:page-aliases: user-guide.adoc
 
 This guide is for developers writing Camel applications on top of Quarkus.
 
@@ -13,4 +14,4 @@ xref:list-of-camel-quarkus-extensions.adoc[complete list].
 
 == What's next?
 
-We recommend to continue with xref:first-steps.adoc[First steps].
+We recommend to continue with xref:user-guide/first-steps.adoc[First steps].
diff --git a/docs/modules/ROOT/pages/native-mode.adoc b/docs/modules/ROOT/pages/user-guide/native-mode.adoc
similarity index 99%
rename from docs/modules/ROOT/pages/native-mode.adoc
rename to docs/modules/ROOT/pages/user-guide/native-mode.adoc
index 449b3c0..0913ead 100644
--- a/docs/modules/ROOT/pages/native-mode.adoc
+++ b/docs/modules/ROOT/pages/user-guide/native-mode.adoc
@@ -1,4 +1,5 @@
 = Native mode
+:page-aliases: native-mode.adoc
 
 Things to consider before you run your application in the native mode.
 
diff --git a/extensions/ahc/runtime/src/main/doc/configuration.adoc b/extensions/ahc/runtime/src/main/doc/configuration.adoc
index 1f97a7a..006aab2 100644
--- a/extensions/ahc/runtime/src/main/doc/configuration.adoc
+++ b/extensions/ahc/runtime/src/main/doc/configuration.adoc
@@ -1,2 +1,2 @@
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
   your application to send or receive requests using non-default encodings.
diff --git a/extensions/http/runtime/src/main/doc/configuration.adoc b/extensions/http/runtime/src/main/doc/configuration.adoc
index 1f97a7a..006aab2 100644
--- a/extensions/http/runtime/src/main/doc/configuration.adoc
+++ b/extensions/http/runtime/src/main/doc/configuration.adoc
@@ -1,2 +1,2 @@
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
   your application to send or receive requests using non-default encodings.
diff --git a/extensions/mustache/runtime/src/main/doc/configuration.adoc b/extensions/mustache/runtime/src/main/doc/configuration.adoc
index b450746..643a9d0 100644
--- a/extensions/mustache/runtime/src/main/doc/configuration.adoc
+++ b/extensions/mustache/runtime/src/main/doc/configuration.adoc
@@ -12,4 +12,4 @@ In order to work in native mode the `include-patterns` configuration should be s
 quarkus.camel.native.resources.include-patterns = template/*.mustache
 ----
 
-More information about selecting resources for inclusion in the native executable could be found at xref:native-mode.adoc#embedding-resource-in-native-executable[Embedding resource in native executable].
\ No newline at end of file
+More information about selecting resources for inclusion in the native executable could be found at xref:user-guide/native-mode.adoc#embedding-resource-in-native-executable[Embedding resource in native executable].
\ No newline at end of file
diff --git a/extensions/netty-http/runtime/src/main/doc/configuration.adoc b/extensions/netty-http/runtime/src/main/doc/configuration.adoc
index 1f97a7a..006aab2 100644
--- a/extensions/netty-http/runtime/src/main/doc/configuration.adoc
+++ b/extensions/netty-http/runtime/src/main/doc/configuration.adoc
@@ -1,2 +1,2 @@
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
   your application to send or receive requests using non-default encodings.
diff --git a/extensions/platform-http/runtime/src/main/doc/configuration.adoc b/extensions/platform-http/runtime/src/main/doc/configuration.adoc
index 1f97a7a..006aab2 100644
--- a/extensions/platform-http/runtime/src/main/doc/configuration.adoc
+++ b/extensions/platform-http/runtime/src/main/doc/configuration.adoc
@@ -1,2 +1,2 @@
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you expect
   your application to send or receive requests using non-default encodings.
diff --git a/extensions/stream/runtime/src/main/doc/configuration.adoc b/extensions/stream/runtime/src/main/doc/configuration.adoc
index 648939f..d7f7bd2 100644
--- a/extensions/stream/runtime/src/main/doc/configuration.adoc
+++ b/extensions/stream/runtime/src/main/doc/configuration.adoc
@@ -1,2 +1,2 @@
-* Check the xref:native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you want to use
+* Check the xref:user-guide/native-mode.adoc#charsets[Character encodings section] of the Native mode guide if you want to use
  non-default encodings for the stream endpoint `encoding` URI parameter.
diff --git a/tooling/package-maven-plugin/src/main/resources/doc-templates/extension-doc-page.adoc b/tooling/package-maven-plugin/src/main/resources/doc-templates/extension-doc-page.adoc
index 8015271..0e5c2de 100644
--- a/tooling/package-maven-plugin/src/main/resources/doc-templates/extension-doc-page.adoc
+++ b/tooling/package-maven-plugin/src/main/resources/doc-templates/extension-doc-page.adoc
@@ -25,7 +25,7 @@ Please refer to the above link[#if models?size != 1]s[/#if] for usage and config
 </dependency>
 ----
 
-Check the xref:user-guide.adoc[User guide] for more information about writing Camel Quarkus applications.
+Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
 [#if usage?? ]
 
 == Usage