Sync documentation of main branch

Author: actions-user

_data/versioned/main/index/quarkus.yaml

@@ -5,7 +5,7 @@ types:
   - title: Authorization of web endpoints
     filename: security-authorize-web-endpoints-reference.adoc
     summary: Quarkus has an integrated pluggable web security layer.
-    categories: "web, security"
+    categories: "security, web"
     id: security-authorize-web-endpoints-reference
     type: reference
     url: /guides/security-authorize-web-endpoints-reference
@@ -18,7 +18,7 @@ types:
   - title: Command Mode Applications
     filename: command-mode-reference.adoc
     summary: This reference guide explains how to develop command line applications with Quarkus.
-    categories: "command-line, core"
+    categories: "core, command-line"
     type: reference
     url: /guides/command-mode-reference
   - title: Configuration Reference Guide
@@ -60,6 +60,8 @@ types:
   - title: Native Reference Guide
     filename: native-reference.adoc
     summary: "This guide is a companion to the Building a Native Executable, Using SSL With Native Images, and Writing Native Applications, guides."
+    categories: native
+    id: native-reference
     type: reference
     url: /guides/native-reference
   - title: OpenID Connect (OIDC) and OAuth2 Client and Filters Reference Guide
@@ -129,14 +131,14 @@ types:
   - title: Authentication mechanisms in Quarkus
     filename: security-authentication-mechanisms-concept.adoc
     summary: "The Quarkus Security framework supports multiple authentication mechanisms, which you can use to secure your applications."
-    categories: "web, security"
+    categories: "security, web"
     id: security-authentication-mechanisms-concept
     type: concepts
     url: /guides/security-authentication-mechanisms-concept
   - title: Basic authentication
     filename: security-basic-authentication-concept.adoc
     summary: HTTP Basic authentication is one of the least resource-demanding techniques that enforce access controls to web resources.
-    categories: "web, security"
+    categories: "security, web"
     id: security-basic-authentication-concept
     type: concepts
     url: /guides/security-basic-authentication-concept
@@ -150,21 +152,21 @@ types:
   - title: OpenID Connect (OIDC) Bearer authentication
     filename: security-oidc-bearer-token-authentication-concept.adoc
     summary: Secure HTTP access to Jakarta REST (formerly known as JAX-RS) endpoints in your application with Bearer authentication by using the Quarkus OpenID Connect (OIDC) extension.
-    categories: "web, security"
+    categories: "security, web"
     id: security-oidc-bearer-token-authentication-concept
     type: concepts
     url: /guides/security-oidc-bearer-token-authentication-concept
   - title: OpenID Connect authorization code flow mechanism for protecting web applications
     filename: security-oidc-code-flow-authentication-concept.adoc
     summary: "To protect your web applications, you can use the authorization code flow mechanism provided by the Quarkus OpenID Connect (OIDC) extension."
-    categories: "web, security"
+    categories: "security, web"
     id: security-oidc-code-flow-authentication-concept
     type: concepts
     url: /guides/security-oidc-code-flow-authentication-concept
   - title: Proactive authentication
     filename: security-proactive-authentication-concept.adoc
     summary: Proactive authentication is enabled in Quarkus by default.
-    categories: "web, security"
+    categories: "security, web"
     id: security-proactive-authentication-concept
     type: concepts
     url: /guides/security-proactive-authentication-concept
@@ -228,13 +230,14 @@ types:
   - title: Building a Native Executable
     filename: building-native-image.adoc
     summary: Build native executables with GraalVM or Mandrel.
-    categories: getting-started
+    categories: "getting-started, native"
     type: tutorial
     url: /guides/building-native-image
   - title: Collect metrics using Micrometer
     filename: telemetry-micrometer-tutorial.adoc
     summary: "Create an application that uses the Micrometer metrics library to collect runtime, extension and application metrics and expose them as a Prometheus (OpenMetrics) endpoint."
-    id: tutorial-micrometer
+    categories: observability
+    id: telemetry-micrometer-tutorial
     type: tutorial
     url: /guides/telemetry-micrometer-tutorial
   - title: Configure data sources in Quarkus
@@ -273,7 +276,7 @@ types:
   - title: Protect a web application by using OpenID Connect (OIDC) authorization code flow
     filename: security-oidc-code-flow-authentication-tutorial.adoc
     summary: "With the Quarkus OpenID Connect (OIDC) extension, you can protect application HTTP endpoints by using the OIDC Authorization Code Flow mechanism."
-    categories: "web, security"
+    categories: "security, web"
     id: security-oidc-code-flow-authentication-tutorial
     type: tutorial
     url: /guides/security-oidc-code-flow-authentication-tutorial
@@ -342,7 +345,7 @@ types:
   - title: AppCDS
     filename: appcds.adoc
     summary: This reference guide explains how to enable AppCDS with Quarkus.
-    categories: "cloud, core"
+    categories: "core, cloud"
     type: guide
     url: /guides/appcds
   - title: Application Data Caching
@@ -386,24 +389,12 @@ types:
     summary: "According to RFC7519, JSON Web Token (JWT) is a compact, URL-safe means of representing claims which are encoded as a JSON object that is used as the payload of a JSON Web Signature (JWS) structure or as the plaintext of a JSON Web Encryption (JWE) structure, enabling the claims to be digitally signed or integrity protected with a Message Authentication Code(MAC) and/or encrypted."
     type: guide
     url: /guides/security-jwt-build
-  - title: Building Quarkus apps with Gradle
-    filename: gradle-tooling.adoc
-    summary: "This guide covers: Gradle configuration, creating a new project, dealing with extensions, development mode, debugging, import in your IDE, building a native image, and build a container friendly executable"
-    categories: tooling
-    type: guide
-    url: /guides/gradle-tooling
   - title: Building Quarkus apps with Quarkus Command Line Interface (CLI)
     filename: cli-tooling.adoc
     summary: "Use the Quarkus CLI to create, build, run, and manage extensions for Quarkus projects."
     categories: tooling
     type: guide
     url: /guides/cli-tooling
-  - title: Building applications with Maven
-    filename: maven-tooling.adoc
-    summary: "This guide covers: Maven configuration, creating a new project, dealing with extensions, development mode, debugging, import in your IDE, building a native image, and build a container friendly executable"
-    categories: tooling
-    type: guide
-    url: /guides/maven-tooling
   - title: Building my first extension
     filename: building-my-first-extension.adoc
     summary: Learn step by step how to build a simple extension.
@@ -493,7 +484,8 @@ types:
   - title: Deploying on OpenShift
     filename: deploying-to-openshift.adoc
     summary: This guide covers how to deploy a native application on OpenShift.
-    categories: cloud
+    categories: "native, cloud"
+    id: deploy-openshift
     type: guide
     url: /guides/deploying-to-openshift
   - title: Deploying to Google Cloud Platform (GCP)
@@ -541,7 +533,7 @@ types:
   - title: Dev Services for Databases
     filename: databases-dev-services.adoc
     summary: "When testing or running in dev mode Quarkus can provide you with a zero-config database out of the box, a feature we refer to as Dev Services."
-    categories: "tooling, data"
+    categories: "data, tooling"
     type: guide
     url: /guides/databases-dev-services
   - title: Dev Services for Elasticsearch
@@ -753,7 +745,8 @@ types:
   - title: Kubernetes extension
     filename: deploying-to-kubernetes.adoc
     summary: This guide covers how to deploy a native application on Kubernetes.
-    categories: cloud
+    categories: "native, cloud"
+    id: deploy-kubernetes
     type: guide
     url: /guides/deploying-to-kubernetes
   - title: Mapping configuration to objects
@@ -775,11 +768,12 @@ types:
     type: guide
     url: /guides/tests-with-coverage
   - title: Micrometer Metrics
-    filename: micrometer.adoc
-    summary: This guide demonstrates how your Quarkus application can collect metrics using the Micrometer extension.
+    filename: telemetry-micrometer.adoc
+    summary: "Use Micrometer to collect metrics produced by Quarkus, its extensions, and your application."
     categories: observability
+    id: telemetry-micrometer
     type: guide
-    url: /guides/micrometer
+    url: /guides/telemetry-micrometer
   - title: Migrating to RESTEasy Reactive
     filename: resteasy-reactive-migration.adoc
     summary: "Migrating from RESTEasy Classic to RESTEasy Reactive is straightforward in most cases, however there are a few cases that require some attention."
@@ -876,6 +870,20 @@ types:
     categories: architecture
     type: guide
     url: /guides/quarkus-reactive-architecture
+  - title: Quarkus and Gradle
+    filename: gradle-tooling.adoc
+    summary: Develop and build your Quarkus application with Gradle
+    categories: "tooling, native"
+    id: gradle-tooling
+    type: guide
+    url: /guides/gradle-tooling
+  - title: Quarkus and Maven
+    filename: maven-tooling.adoc
+    summary: Develop and build your Quarkus application with Maven
+    categories: "tooling, native"
+    id: maven-tooling
+    type: guide
+    url: /guides/maven-tooling
   - title: Qute Templating Engine
     filename: qute.adoc
     summary: Learn more about how you can use templating in your applications with the Qute template engine.
@@ -1000,13 +1008,14 @@ types:
   - title: Testing Your Application
     filename: getting-started-testing.adoc
     summary: "This guide covers testing in JVM mode, native mode, and injection of resources into tests"
-    categories: core
+    categories: "core, tooling, native"
+    id: testing
     type: guide
     url: /guides/getting-started-testing
   - title: Tips for writing native applications
     filename: writing-native-applications-tips.adoc
     summary: This guide is a collection of tips to help you solve the problems you encounter when compiling applications to native executable.
-    categories: "writing-extensions, core"
+    categories: "core, writing-extensions, native"
     type: guide
     url: /guides/writing-native-applications-tips
   - title: Update projects to the latest version of Quarkus
@@ -1142,7 +1151,7 @@ types:
   - title: Using SSL With Native Executables
     filename: native-and-ssl.adoc
     summary: "In this guide, we will discuss how you can get your native images to support SSL, as native images don't support it out of the box."
-    categories: "core, security"
+    categories: "core, security, native"
     type: guide
     url: /guides/native-and-ssl
   - title: Using Security with .properties File
@@ -1249,13 +1258,13 @@ types:
   - title: Validation with Hibernate Validator
     filename: validation.adoc
     summary: This guide covers how to use Hibernate Validator/Bean Validation in your REST services.
-    categories: "web, data"
+    categories: "data, web"
     type: guide
     url: /guides/validation
   - title: Writing JSON REST Services
     filename: rest-json.adoc
     summary: JSON is now the lingua franca between microservices.
-    categories: "web, serialization"
+    categories: "serialization, web"
     type: guide
     url: /guides/rest-json
   - title: Writing REST Services with RESTEasy Reactive