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
@@ -335,7 +335,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
@@ -945,7 +945,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: "data, alt-languages"
+    categories: "alt-languages, data"
     type: guide
     url: /guides/hibernate-orm-panache-kotlin
   - title: Simplified Hibernate Reactive with Panache
@@ -963,13 +963,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: "data, alt-languages"
+    categories: "alt-languages, data"
     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
@@ -1005,7 +1005,7 @@ types:
   - 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"
     type: guide
     url: /guides/writing-native-applications-tips
   - title: Update projects to the latest version of Quarkus
@@ -1248,13 +1248,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: "data, web"
+    categories: "web, data"
     type: guide
     url: /guides/validation
   - title: Writing JSON REST Services
     filename: rest-json.adoc
     summary: JSON is now the lingua franca between microservices.
-    categories: "serialization, web"
+    categories: "web, serialization"
     type: guide
     url: /guides/rest-json
   - title: Writing REST Services with RESTEasy Reactive

_generated-doc/main/config/all-configuration-groups-generated-doc/io.quarkus.kubernetes.deployment.RouteConfig

@@ -1 +1 @@
-[{"configDocKey":{"type":"boolean","key":".expose","configDoc":"If true, the service will be exposed","withinAMap":false,"defaultValue":"false","javaDocSiteLink":"","docMapKey":"expose","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".host","configDoc":"The host under which the application is going to be exposed","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"host","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".target-port","configDoc":"The target named port. If not provided, it will be deducted from the Service resource ports. Options are: \"http\" and \"https\".","withinAMap":false,"defaultValue":"http","javaDocSiteLink":"","docMapKey":"target-port","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"`Map<String,String>`","key":".annotations","configDoc":"Custom annotations to add to exposition (route or ingress) resources","withinAMap":true,"defaultValue":"","javaDocSiteLink":"","docMapKey":"annotations","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":true,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocSection":{"name":"","optional":false,"withinAMap":false,"sectionDetails":null,"sectionDetailsTitle":".tls","configPhase":"BUILD_TIME","topLevelGrouping":"","configGroupType":"io.quarkus.kubernetes.deployment.TLSConfig","showSection":false,"configDocItems":[{"configDocKey":{"type":"string","key":".tls.ca-certificate","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"ca-certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.certificate","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.destination-ca-certificate","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"destination-ca-certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.insecure-edge-termination-policy","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"insecure-edge-termination-policy","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.key","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"key","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.termination","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"termination","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}}],"anchorPrefix":null}}]
+[{"configDocKey":{"type":"boolean","key":".expose","configDoc":"If true, the service will be exposed","withinAMap":false,"defaultValue":"false","javaDocSiteLink":"","docMapKey":"expose","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".host","configDoc":"The host under which the application is going to be exposed","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"host","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".target-port","configDoc":"The target named port. If not provided, it will be deducted from the Service resource ports. Options are: \"http\" and \"https\".","withinAMap":false,"defaultValue":"http","javaDocSiteLink":"","docMapKey":"target-port","configPhase":"BUILD_TIME","acceptedValues":null,"optional":false,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"`Map<String,String>`","key":".annotations","configDoc":"Custom annotations to add to exposition (route or ingress) resources","withinAMap":true,"defaultValue":"","javaDocSiteLink":"","docMapKey":"annotations","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":true,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocSection":{"name":"","optional":false,"withinAMap":false,"sectionDetails":null,"sectionDetailsTitle":".tls","configPhase":"BUILD_TIME","topLevelGrouping":"","configGroupType":"io.quarkus.kubernetes.deployment.TLSConfig","showSection":false,"configDocItems":[{"configDocKey":{"type":"string","key":".tls.ca-certificate","configDoc":"The cert authority certificate contents.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"ca-certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.certificate","configDoc":"The certificate contents.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.destination-ca-certificate","configDoc":"The contents of the ca certificate of the final destination.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"destination-ca-certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.insecure-edge-termination-policy","configDoc":"The desired behavior for insecure connections to a route.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"insecure-edge-termination-policy","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.key","configDoc":"The key file contents.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"key","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".tls.termination","configDoc":"The termination type.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"termination","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}}],"anchorPrefix":null}}]

_generated-doc/main/config/all-configuration-groups-generated-doc/io.quarkus.kubernetes.deployment.TLSConfig

@@ -1 +1 @@
-[{"configDocKey":{"type":"string","key":".ca-certificate","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"ca-certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".certificate","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".destination-ca-certificate","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"destination-ca-certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".insecure-edge-termination-policy","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"insecure-edge-termination-policy","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".key","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"key","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".termination","configDoc":"","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"termination","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}}]
+[{"configDocKey":{"type":"string","key":".ca-certificate","configDoc":"The cert authority certificate contents.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"ca-certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".certificate","configDoc":"The certificate contents.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".destination-ca-certificate","configDoc":"The contents of the ca certificate of the final destination.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"destination-ca-certificate","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".insecure-edge-termination-policy","configDoc":"The desired behavior for insecure connections to a route.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"insecure-edge-termination-policy","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".key","configDoc":"The key file contents.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"key","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}},{"configDocKey":{"type":"string","key":".termination","configDoc":"The termination type.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"termination","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":true,"topLevelGrouping":"","enum":false}}]

_generated-doc/main/config/all-configuration-roots-generated-doc/io.quarkus.kubernetes.deployment.OpenshiftConfig

@@ -728,7 +728,7 @@ a| `String propertyName` :: +++<i>No Javadoc found</i>+++
 `Type propertyType` :: +++<i>No Javadoc found</i>+++
 `String defaultValue` :: +++<i>No Javadoc found</i>+++
 
-a| https://github.com/quarkusio/quarkus/blob/main/extensions/arc/deployment/src/main/java/io/quarkus/arc/deployment/ContextRegistrationPhaseBuildItem.java[`io.quarkus.arc.deployment.ContextRegistrationPhaseBuildItem`, window="_blank"] :: +++Context registration phase can be used to register custom CDI contexts. <p> An extension that needs to produce other build items during the "context registration" phase should use this build item. The build step should produce a  or at least inject a  for this build item, otherwise it could be ignored or processed at the wrong time, e.g. after .+++
+a| https://github.com/quarkusio/quarkus/blob/main/extensions/arc/deployment/src/main/java/io/quarkus/arc/deployment/ContextRegistrationPhaseBuildItem.java[`io.quarkus.arc.deployment.ContextRegistrationPhaseBuildItem`, window="_blank"] :: +++Context registration phase can be used to register custom CDI contexts. <p> An extension that needs to produce other build items during the "context registration" phase should use this build item. The build step should produce a  or at least inject a  for this build item, otherwise it could be ignored or processed at the wrong time, e.g. after . <p> Typical workflow involves obtaining a  via . Note that there is no need to invoke  once you are done as it is performed automatically.+++
 a| `BeanProcessor beanProcessor` :: +++<i>No Javadoc found</i>+++
 `ContextRegistrar.RegistrationContext context` :: +++<i>No Javadoc found</i>+++
 

_generated-doc/main/config/quarkus-all-build-items.adoc

@@ -32161,6 +32161,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes_quarkus.openshift.ro
 
 [.description]
 --
+The cert authority certificate contents.
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_OPENSHIFT_ROUTE_TLS_CA_CERTIFICATE+++[]
 endif::add-copy-button-to-env-var[]
@@ -32175,6 +32177,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes_quarkus.openshift.ro
 
 [.description]
 --
+The certificate contents.
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_OPENSHIFT_ROUTE_TLS_CERTIFICATE+++[]
 endif::add-copy-button-to-env-var[]
@@ -32189,6 +32193,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes_quarkus.openshift.ro
 
 [.description]
 --
+The contents of the ca certificate of the final destination.
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_OPENSHIFT_ROUTE_TLS_DESTINATION_CA_CERTIFICATE+++[]
 endif::add-copy-button-to-env-var[]
@@ -32203,6 +32209,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes_quarkus.openshift.ro
 
 [.description]
 --
+The desired behavior for insecure connections to a route.
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_OPENSHIFT_ROUTE_TLS_INSECURE_EDGE_TERMINATION_POLICY+++[]
 endif::add-copy-button-to-env-var[]
@@ -32217,6 +32225,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes_quarkus.openshift.ro
 
 [.description]
 --
+The key file contents.
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_OPENSHIFT_ROUTE_TLS_KEY+++[]
 endif::add-copy-button-to-env-var[]
@@ -32231,6 +32241,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes_quarkus.openshift.ro
 
 [.description]
 --
+The termination type.
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_OPENSHIFT_ROUTE_TLS_TERMINATION+++[]
 endif::add-copy-button-to-env-var[]