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
@@ -30,7 +30,7 @@ types:
   - title: Configure data sources in Quarkus
     filename: datasource.adoc
     summary: Use a unified configuration model to define datasources for Java Database Connectivity (JDBC) and Reactive drivers.
-    categories: "data, getting-started"
+    categories: "getting-started, data"
     id: datasources
     type: reference
     url: /guides/datasource
@@ -145,14 +145,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
@@ -166,21 +166,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 industry-standard 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
@@ -215,7 +215,7 @@ types:
   - title: Security vulnerability detection and reporting in Quarkus
     filename: security-vulnerability-detection-concept.adoc
     summary: Most of the Quarkus tags are registered in the US National Vulnerability Database (NVD) in Common Platform Enumeration (CPE) name format.
-    categories: "security, contributing"
+    categories: "contributing, security"
     id: security-vulnerability-detection-concept
     type: concepts
     url: /guides/security-vulnerability-detection-concept
@@ -244,7 +244,7 @@ types:
   - title: Building a Native Executable
     filename: building-native-image.adoc
     summary: Build native executables with GraalVM or Mandrel.
-    categories: "native, getting-started"
+    categories: "getting-started, native"
     type: tutorial
     url: /guides/building-native-image
   - title: Collect metrics using Micrometer
@@ -283,7 +283,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
@@ -296,7 +296,7 @@ types:
   - title: Secure a Quarkus application with Basic authentication and Jakarta Persistence
     filename: security-basic-authentication-tutorial.adoc
     summary: Secure your Quarkus application endpoints by combining the built-in Quarkus Basic authentication with the Jakarta Persistence identity provider to enable role-based access control (RBAC).
-    categories: "security, getting-started"
+    categories: "getting-started, security"
     id: security-basic-authentication-tutorial
     type: tutorial
     url: /guides/security-basic-authentication-tutorial
@@ -391,6 +391,11 @@ types:
     categories: writing-extensions
     type: guide
     url: /guides/all-builditems
+  - title: Build analytics
+    filename: build-analytics.adoc
+    summary: This guide presents what build analytics is and how to configure it.
+    type: guide
+    url: /guides/build-analytics
   - title: "Build, Sign and Encrypt JSON Web Tokens"
     filename: security-jwt-build.adoc
     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."
@@ -491,7 +496,7 @@ types:
   - title: Deploying on OpenShift
     filename: deploying-to-openshift.adoc
     summary: This guide covers how to deploy a native application on OpenShift.
-    categories: "native, cloud"
+    categories: "cloud, native"
     id: deploy-openshift
     type: guide
     url: /guides/deploying-to-openshift
@@ -546,7 +551,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
@@ -583,6 +588,12 @@ types:
     categories: data
     type: guide
     url: /guides/redis-dev-services
+  - title: Dev UI
+    filename: dev-ui-v2.adoc
+    summary: Learn how to get your extension to contribute features to the Dev UI (v2).
+    categories: writing-extensions
+    type: guide
+    url: /guides/dev-ui-v2
   - title: Dev UI
     filename: dev-ui.adoc
     summary: Learn how to get your extension contribute features to the Dev UI (v1).
@@ -758,7 +769,7 @@ types:
   - title: Kubernetes extension
     filename: deploying-to-kubernetes.adoc
     summary: This guide covers how to deploy a native application on Kubernetes.
-    categories: "native, cloud"
+    categories: "cloud, native"
     id: deploy-kubernetes
     type: guide
     url: /guides/deploying-to-kubernetes
@@ -1015,14 +1026,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, core, native"
+    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: "core, native, writing-extensions"
+    categories: "core, writing-extensions, native"
     type: guide
     url: /guides/writing-native-applications-tips
   - title: Update projects to the latest version of Quarkus
@@ -1158,7 +1169,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, native, security"
+    categories: "core, security, native"
     type: guide
     url: /guides/native-and-ssl
   - title: Using Security with .properties File
@@ -1265,13 +1276,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-roots-generated-doc/io.quarkus.runtime.BuildAnalyticsConfig

@@ -0,0 +1 @@
+[{"configDocKey":{"type":"java.lang.Boolean","key":"quarkus.analytics.disabled","configDoc":"If Build time analytics are disabled.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"disabled","configPhase":"BUILD_AND_RUN_TIME_FIXED","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":false,"topLevelGrouping":"quarkus.analytics","enum":false}},{"configDocKey":{"type":"string","key":"quarkus.analytics.uri-base","configDoc":"The Segment base URI.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"uri-base","configPhase":"BUILD_AND_RUN_TIME_FIXED","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":false,"topLevelGrouping":"quarkus.analytics","enum":false}},{"configDocKey":{"type":"java.lang.Integer","key":"quarkus.analytics.timeout","configDoc":"The Timeout to send the build time analytics to segment.","withinAMap":false,"defaultValue":"3000","javaDocSiteLink":"","docMapKey":"timeout","configPhase":"BUILD_AND_RUN_TIME_FIXED","acceptedValues":null,"optional":true,"list":false,"passThroughMap":false,"withinAConfigGroup":false,"topLevelGrouping":"quarkus.analytics","enum":false}}]

_generated-doc/main/config/extensions-configuration-roots-list/quarkus-core.adoc/io.quarkus.runtime.BuildAnalyticsConfig

@@ -0,0 +1 @@
+io.quarkus.runtime.BuildAnalyticsConfig

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

@@ -1461,7 +1461,11 @@ a| None
 [%header,cols=2*]
 |===
 |Class Name |Attributes 
-a| https://github.com/quarkusio/quarkus/blob/main/extensions/netty/deployment/src/main/java/io/quarkus/netty/deployment/EventLoopSupplierBuildItem.java[`io.quarkus.netty.deployment.EventLoopSupplierBuildItem`, window="_blank"] :: +++<i>No Javadoc found</i>+++
+a| https://github.com/quarkusio/quarkus/blob/main/extensions/netty/deployment/src/main/java/io/quarkus/netty/deployment/EventLoopGroupBuildItem.java[`io.quarkus.netty.deployment.EventLoopGroupBuildItem`, window="_blank"] :: +++Provides suppliers that return EventLoopGroup used by the application. See EventLoopSupplierBuildItem to register custom EventLoopGroup+++
+a| `Supplier bossEventLoopGroup` :: +++<i>No Javadoc found</i>+++
+`Supplier mainEventLoopGroup` :: +++<i>No Javadoc found</i>+++
+
+a| https://github.com/quarkusio/quarkus/blob/main/extensions/netty/deployment/src/main/java/io/quarkus/netty/deployment/EventLoopSupplierBuildItem.java[`io.quarkus.netty.deployment.EventLoopSupplierBuildItem`, window="_blank"] :: +++Register EventLoopGroup suppliers to be used to produce main EventLoopGroup and boss EventLoopGroup annotated beans. If not provided, both will be created from a default supplier. See EventLoopGroupBuildItem for actual supplier instances+++
 a| `Supplier mainSupplier` :: +++<i>No Javadoc found</i>+++
 `Supplier bossSupplier` :: +++<i>No Javadoc found</i>+++
 

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

@@ -50133,6 +50133,54 @@ endif::add-copy-button-to-env-var[]
 |
 
 
+a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus.analytics.disabled]]`link:#quarkus-core_quarkus.analytics.disabled[quarkus.analytics.disabled]`
+
+[.description]
+--
+If Build time analytics are disabled.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_DISABLED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_DISABLED+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|
+
+
+a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus.analytics.uri-base]]`link:#quarkus-core_quarkus.analytics.uri-base[quarkus.analytics.uri-base]`
+
+[.description]
+--
+The Segment base URI.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_URI_BASE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_URI_BASE+++`
+endif::add-copy-button-to-env-var[]
+--|string 
+|
+
+
+a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus.analytics.timeout]]`link:#quarkus-core_quarkus.analytics.timeout[quarkus.analytics.timeout]`
+
+[.description]
+--
+The Timeout to send the build time analytics to segment.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_TIMEOUT+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_TIMEOUT+++`
+endif::add-copy-button-to-env-var[]
+--|int 
+|`3000`
+
+
 a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus.application.name]]`link:#quarkus-core_quarkus.application.name[quarkus.application.name]`
 
 [.description]

_generated-doc/main/config/quarkus-analytics-build-analytics-config.adoc

@@ -0,0 +1,60 @@
+
+:summaryTableId: quarkus-analytics-build-analytics-config
+[.configuration-legend]
+icon:lock[title=Fixed at build time] Configuration property fixed at build time - All other configuration properties are overridable at runtime
+[.configuration-reference, cols="80,.^10,.^10"]
+|===
+
+h|[[quarkus-analytics-build-analytics-config_configuration]]link:#quarkus-analytics-build-analytics-config_configuration[Configuration property]
+
+h|Type
+h|Default
+
+a|icon:lock[title=Fixed at build time] [[quarkus-analytics-build-analytics-config_quarkus.analytics.disabled]]`link:#quarkus-analytics-build-analytics-config_quarkus.analytics.disabled[quarkus.analytics.disabled]`
+
+[.description]
+--
+If Build time analytics are disabled.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_DISABLED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_DISABLED+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|
+
+
+a|icon:lock[title=Fixed at build time] [[quarkus-analytics-build-analytics-config_quarkus.analytics.uri-base]]`link:#quarkus-analytics-build-analytics-config_quarkus.analytics.uri-base[quarkus.analytics.uri-base]`
+
+[.description]
+--
+The Segment base URI.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_URI_BASE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_URI_BASE+++`
+endif::add-copy-button-to-env-var[]
+--|string 
+|
+
+
+a|icon:lock[title=Fixed at build time] [[quarkus-analytics-build-analytics-config_quarkus.analytics.timeout]]`link:#quarkus-analytics-build-analytics-config_quarkus.analytics.timeout[quarkus.analytics.timeout]`
+
+[.description]
+--
+The Timeout to send the build time analytics to segment.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_TIMEOUT+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_TIMEOUT+++`
+endif::add-copy-button-to-env-var[]
+--|int 
+|`3000`
+
+|===

_generated-doc/main/config/quarkus-core.adoc

@@ -165,6 +165,54 @@ endif::add-copy-button-to-env-var[]
 |
 
 
+a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus.analytics.disabled]]`link:#quarkus-core_quarkus.analytics.disabled[quarkus.analytics.disabled]`
+
+[.description]
+--
+If Build time analytics are disabled.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_DISABLED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_DISABLED+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|
+
+
+a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus.analytics.uri-base]]`link:#quarkus-core_quarkus.analytics.uri-base[quarkus.analytics.uri-base]`
+
+[.description]
+--
+The Segment base URI.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_URI_BASE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_URI_BASE+++`
+endif::add-copy-button-to-env-var[]
+--|string 
+|
+
+
+a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus.analytics.timeout]]`link:#quarkus-core_quarkus.analytics.timeout[quarkus.analytics.timeout]`
+
+[.description]
+--
+The Timeout to send the build time analytics to segment.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ANALYTICS_TIMEOUT+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ANALYTICS_TIMEOUT+++`
+endif::add-copy-button-to-env-var[]
+--|int 
+|`3000`
+
+
 a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus.application.name]]`link:#quarkus-core_quarkus.application.name[quarkus.application.name]`
 
 [.description]