Sync documentation of main branch

Author: actions-user

_data/versioned/main/index/quarkus.yaml

@@ -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
@@ -173,7 +173,7 @@ types:
   - title: "Duplicated context, context locals, asynchronous processing and propagation"
     filename: duplicated-context.adoc
     summary: "When using a traditional, blocking, and synchronous framework, processing of each request is performed in a dedicated thread."
-    categories: "architecture, core"
+    categories: "core, architecture"
     id: duplicated-context
     type: concepts
     url: /guides/duplicated-context
@@ -229,7 +229,7 @@ types:
   - title: Security vulnerability detection and reporting in Quarkus
     filename: security-vulnerability-detection.adoc
     summary: Most of the Quarkus tags are registered in the US National Vulnerability Database (NVD) in Common Platform Enumeration (CPE) name format.
-    categories: "contributing, security"
+    categories: "security, contributing"
     id: security-vulnerability-detection
     type: concepts
     url: /guides/security-vulnerability-detection
@@ -258,7 +258,7 @@ types:
   - title: Use virtual threads in REST applications
     filename: resteasy-reactive-virtual-threads.adoc
     summary: How to use virtual threads in a REST application
-    categories: "web, core"
+    categories: "core, web"
     id: resteasy-reactive-virtual-threads
     type: howto
     url: /guides/resteasy-reactive-virtual-threads
@@ -328,6 +328,13 @@ types:
     categories: getting-started
     type: tutorial
     url: /guides/tooling
+  - title: Your second Quarkus application
+    filename: getting-started-dev-services.adoc
+    summary: This tutorial shows you how to create an application which writes to and reads from a database.
+    categories: "getting-started, core, data"
+    id: getting-started-dev-services-tutorial
+    type: tutorial
+    url: /guides/getting-started-dev-services
   guide:
   - title: AWS Lambda
     filename: aws-lambda.adoc
@@ -380,7 +387,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
@@ -573,7 +580,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
@@ -941,14 +948,14 @@ types:
   - title: Quarkus and Gradle
     filename: gradle-tooling.adoc
     summary: Develop and build your Quarkus application with Gradle
-    categories: "tooling, native"
+    categories: "native, tooling"
     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"
+    categories: "native, tooling"
     id: maven-tooling
     type: guide
     url: /guides/maven-tooling
@@ -1022,7 +1029,7 @@ types:
   - title: Simplified Hibernate ORM with Panache and Kotlin
     filename: hibernate-orm-panache-kotlin.adoc
     summary: This explains the specifics of using Hibernate ORM with Panache in a Kotlin project.
-    categories: "alt-languages, data"
+    categories: "data, alt-languages"
     type: guide
     url: /guides/hibernate-orm-panache-kotlin
   - title: Simplified Hibernate Reactive with Panache
@@ -1040,13 +1047,13 @@ types:
   - title: Simplified MongoDB with Panache and Kotlin
     filename: mongodb-panache-kotlin.adoc
     summary: This guide covers the usage of MongoDB using active records and repositories in a Kotlin project.
-    categories: "alt-languages, data"
+    categories: "data, alt-languages"
     type: guide
     url: /guides/mongodb-panache-kotlin
   - title: SmallRye Fault Tolerance
     filename: smallrye-fault-tolerance.adoc
     summary: This guide demonstrates how your Quarkus application can utilize the SmallRye Fault Tolerance specification through the SmallRye Fault Tolerance extension.
-    categories: "observability, web"
+    categories: "web, observability"
     type: guide
     url: /guides/smallrye-fault-tolerance
   - title: SmallRye GraphQL
@@ -1076,14 +1083,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: "tooling, native, core"
+    categories: "core, native, tooling"
     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: "native, core, writing-extensions"
+    categories: "writing-extensions, core, native"
     type: guide
     url: /guides/writing-native-applications-tips
   - title: Using Apache Kafka Streams
@@ -1212,7 +1219,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: "native, security, core"
+    categories: "core, security, native"
     type: guide
     url: /guides/native-and-ssl
   - title: Using Security with .properties File
@@ -1325,13 +1332,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

_generated-doc/main/config/all-configuration-groups-generated-doc/io.quarkus.logging.json.runtime.JsonLogConfig.JsonConfig

@@ -1 +1 @@
-[{"configDocKey":{"type":"boolean","key":"","additionalKeys":[],"configDoc":"Determine whether to enable the JSON console formatting extension, which disables \"normal\" console formatting.","withinAMap":false,"defaultValue":"true","javaDocSiteLink":"","docMapKey":"enable","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"boolean","key":".pretty-print","additionalKeys":[],"configDoc":"Enable \"pretty printing\" of the JSON record. Note that some JSON parsers will fail to read pretty printed output.","withinAMap":false,"defaultValue":"false","javaDocSiteLink":"","docMapKey":"pretty-print","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".date-format","additionalKeys":[],"configDoc":"The date format to use. The special string \"default\" indicates that the default format should be used.","withinAMap":false,"defaultValue":"default","javaDocSiteLink":"","docMapKey":"date-format","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".record-delimiter","additionalKeys":[],"configDoc":"The special end-of-record delimiter to be used. By default, newline is used as delimiter.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"record-delimiter","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".zone-id","additionalKeys":[],"configDoc":"The zone ID to use. The special string \"default\" indicates that the default zone should be used.","withinAMap":false,"defaultValue":"default","javaDocSiteLink":"","docMapKey":"zone-id","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"org.jboss.logmanager.formatters.StructuredFormatter.ExceptionOutputType","key":".exception-output-type","additionalKeys":[],"configDoc":"The exception output type to specify.","withinAMap":false,"defaultValue":"detailed","javaDocSiteLink":"","docMapKey":"exception-output-type","configPhase":"BUILD_TIME","acceptedValues":["`detailed`","`formatted`","`detailed-and-formatted`"],"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":true}},{"configDocKey":{"type":"boolean","key":".print-details","additionalKeys":[],"configDoc":"Enable printing of more details in the log.\n\nPrinting the details can be expensive as the values are retrieved from the caller. The details include the source class name, source file name, source method name and source line number.","withinAMap":false,"defaultValue":"false","javaDocSiteLink":"","docMapKey":"print-details","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".key-overrides","additionalKeys":[],"configDoc":"Override keys with custom values. Omitting this value indicates that no key overrides will be applied.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"key-overrides","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".excluded-keys","additionalKeys":[],"configDoc":"Keys to be excluded from the Json output.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"excluded-keys","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":true,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocSection":{"name":"","optional":false,"withinAMap":false,"sectionDetails":null,"sectionDetailsTitle":".additional-field.\"field-name\"","configPhase":"BUILD_TIME","topLevelGrouping":"","configGroupType":"io.quarkus.logging.json.runtime.AdditionalFieldConfig","showSection":false,"configDocItems":[{"configDocKey":{"type":"string","key":".additional-field.\"field-name\".value","additionalKeys":[],"configDoc":"Additional field value.","withinAMap":true,"defaultValue":"","javaDocSiteLink":"","docMapKey":"value","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"io.quarkus.logging.json.runtime.AdditionalFieldConfig.Type","key":".additional-field.\"field-name\".type","additionalKeys":[],"configDoc":"Additional field type specification. Supported types: string, int, long String is the default if not specified.","withinAMap":true,"defaultValue":"string","javaDocSiteLink":"","docMapKey":"type","configPhase":"BUILD_TIME","acceptedValues":["`string`","`int`","`long`"],"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":true}}],"anchorPrefix":null}}]
+[{"configDocKey":{"type":"boolean","key":"","additionalKeys":[],"configDoc":"Determine whether to enable the JSON console formatting extension, which disables \"normal\" console formatting.","withinAMap":false,"defaultValue":"true","javaDocSiteLink":"","docMapKey":"enable","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"boolean","key":".pretty-print","additionalKeys":[],"configDoc":"Enable \"pretty printing\" of the JSON record. Note that some JSON parsers will fail to read the pretty printed output.","withinAMap":false,"defaultValue":"false","javaDocSiteLink":"","docMapKey":"pretty-print","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".date-format","additionalKeys":[],"configDoc":"The date format to use. The special string \"default\" indicates that the default format should be used.","withinAMap":false,"defaultValue":"default","javaDocSiteLink":"","docMapKey":"date-format","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".record-delimiter","additionalKeys":[],"configDoc":"The special end-of-record delimiter to be used. By default, newline is used.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"record-delimiter","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".zone-id","additionalKeys":[],"configDoc":"The zone ID to use. The special string \"default\" indicates that the default zone should be used.","withinAMap":false,"defaultValue":"default","javaDocSiteLink":"","docMapKey":"zone-id","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"org.jboss.logmanager.formatters.StructuredFormatter.ExceptionOutputType","key":".exception-output-type","additionalKeys":[],"configDoc":"The exception output type to specify.","withinAMap":false,"defaultValue":"detailed","javaDocSiteLink":"","docMapKey":"exception-output-type","configPhase":"BUILD_TIME","acceptedValues":["`detailed`","`formatted`","`detailed-and-formatted`"],"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":true}},{"configDocKey":{"type":"boolean","key":".print-details","additionalKeys":[],"configDoc":"Enable printing of more details in the log.\n\nPrinting the details can be expensive as the values are retrieved from the caller. The details include the source class name, source file name, source method name, and source line number.","withinAMap":false,"defaultValue":"false","javaDocSiteLink":"","docMapKey":"print-details","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".key-overrides","additionalKeys":[],"configDoc":"Override keys with custom values. Omitting this value indicates that no key overrides will be applied.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"key-overrides","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".excluded-keys","additionalKeys":[],"configDoc":"Keys to be excluded from the JSON output.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"excluded-keys","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":true,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocSection":{"name":"","optional":false,"withinAMap":false,"sectionDetails":null,"sectionDetailsTitle":".additional-field.\"field-name\"","configPhase":"BUILD_TIME","topLevelGrouping":"","configGroupType":"io.quarkus.logging.json.runtime.AdditionalFieldConfig","showSection":false,"configDocItems":[{"configDocKey":{"type":"string","key":".additional-field.\"field-name\".value","additionalKeys":[],"configDoc":"Additional field value.","withinAMap":true,"defaultValue":"","javaDocSiteLink":"","docMapKey":"value","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"io.quarkus.logging.json.runtime.AdditionalFieldConfig.Type","key":".additional-field.\"field-name\".type","additionalKeys":[],"configDoc":"Additional field type specification. Supported types: string, int, long String is the default if not specified.","withinAMap":true,"defaultValue":"string","javaDocSiteLink":"","docMapKey":"type","configPhase":"BUILD_TIME","acceptedValues":["`string`","`int`","`long`"],"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":true}}],"anchorPrefix":null}}]

_generated-doc/main/config/all-configuration-groups-generated-doc/io.quarkus.runtime.logging.CategoryBuildTimeConfig

@@ -1 +1 @@
-[{"configDocKey":{"type":"io.quarkus.runtime.logging.InheritableLevel","key":".min-level","additionalKeys":[],"configDoc":"The minimum log level for this category. By default, all categories are configured with `DEBUG` minimum level. To get runtime logging below `DEBUG`, e.g. `TRACE`, the minimum level has to be adjusted at build time, the right log level needs to be provided at runtime. As an example, to get `TRACE` logging, minimum level needs to be at `TRACE` and the runtime log level needs to match that.","withinAMap":false,"defaultValue":"inherit","javaDocSiteLink":"","docMapKey":"min-level","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}}]
+[{"configDocKey":{"type":"io.quarkus.runtime.logging.InheritableLevel","key":".min-level","additionalKeys":[],"configDoc":"The minimum log level for this category. By default, all categories are configured with `DEBUG` minimum level.\n\nTo get runtime logging below `DEBUG`, e.g., `TRACE`, adjust the minimum level at build time. The right log level needs to be provided at runtime.\n\nAs an example, to get `TRACE` logging, minimum level needs to be at `TRACE`, and the runtime log level needs to match that.","withinAMap":false,"defaultValue":"inherit","javaDocSiteLink":"","docMapKey":"min-level","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}}]