Sync documentation of main branch

Author: actions-user

_data/versioned/main/index/quarkus.yaml

@@ -30,7 +30,7 @@ types:
   - title: Configure data sources in Quarkus
     filename: datasource.adoc
     summary: Use a unified configuration model to define data sources for Java Database Connectivity (JDBC) and Reactive drivers.
-    categories: "data, getting-started"
+    categories: "getting-started, data"
     id: datasources
     type: reference
     url: /guides/datasource
@@ -338,7 +338,7 @@ types:
   - title: Your second Quarkus application
     filename: getting-started-dev-services.adoc
     summary: Discover some of the features that make developing with Quarkus a joyful experience.
-    categories: "data, getting-started, core"
+    categories: "getting-started, data, core"
     id: getting-started-dev-services-tutorial
     type: tutorial
     url: /guides/getting-started-dev-services
@@ -528,7 +528,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
@@ -583,7 +583,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: "data, tooling"
+    categories: "tooling, data"
     type: guide
     url: /guides/databases-dev-services
   - title: Dev Services for Elasticsearch
@@ -813,7 +813,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
@@ -1094,7 +1094,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, native, core"
+    categories: "native, writing-extensions, core"
     type: guide
     url: /guides/writing-native-applications-tips
   - title: Using Apache Kafka Streams

_generated-doc/main/config/all-configuration-groups-generated-doc/io.quarkus.restclient.config.RestClientConfig

@@ -289,7 +289,7 @@ a| None
 a| https://github.com/quarkusio/quarkus/blob/main/core/deployment/src/main/java/io/quarkus/deployment/builditem/nativeimage/JPMSExportBuildItem.java[`io.quarkus.deployment.builditem.nativeimage.JPMSExportBuildItem`, window="_blank"] :: +++A build item that indicates that a Java package should be exported using '-J--add-exports' option to become visible to native-image+++
 a| `String moduleName` :: +++<i>No Javadoc found</i>+++
 `String packageName` :: +++<i>No Javadoc found</i>+++
-`GraalVM.Version exportAfter` :: +++<i>No Javadoc found</i>+++
+`GraalVM.Version exportSince` :: +++<i>No Javadoc found</i>+++
 `GraalVM.Version exportBefore` :: +++<i>No Javadoc found</i>+++
 
 a| https://github.com/quarkusio/quarkus/blob/main/core/deployment/src/main/java/io/quarkus/deployment/pkg/builditem/JarBuildItem.java[`io.quarkus.deployment.pkg.builditem.JarBuildItem`, window="_blank"] :: +++<i>No Javadoc found</i>+++

_generated-doc/main/config/all-configuration-roots-generated-doc/io.quarkus.restclient.config.RestClientsConfig

@@ -57471,6 +57471,23 @@ endif::add-copy-button-to-env-var[]
 |
 
 
+a| [[quarkus-rest-client-config_quarkus.rest-client.capture-stacktrace]]`link:#quarkus-rest-client-config_quarkus.rest-client.capture-stacktrace[quarkus.rest-client.capture-stacktrace]`
+
+
+[.description]
+--
+If `true`, the stacktrace of the invocation of the REST Client method is captured. This stacktrace will be used if the invocation throws an exception
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT_CAPTURE_STACKTRACE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT_CAPTURE_STACKTRACE+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|`true`
+
+
 a| [[quarkus-rest-client-config_quarkus.rest-client.-config-key-.multipart.max-chunk-size]]`link:#quarkus-rest-client-config_quarkus.rest-client.-config-key-.multipart.max-chunk-size[quarkus.rest-client."config-key".multipart.max-chunk-size]`
 
 
@@ -57999,6 +58016,23 @@ endif::add-copy-button-to-env-var[]
 |
 
 
+a| [[quarkus-rest-client-config_quarkus.rest-client.-config-key-.capture-stacktrace]]`link:#quarkus-rest-client-config_quarkus.rest-client.-config-key-.capture-stacktrace[quarkus.rest-client."config-key".capture-stacktrace]`
+
+
+[.description]
+--
+If `true`, the stacktrace of the invocation of the REST Client method is captured. This stacktrace will be used if the invocation throws an exception
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|
+
+
 a| [[quarkus-rest-client-config_quarkus.rest-client.headers-headers]]`link:#quarkus-rest-client-config_quarkus.rest-client.headers-headers[quarkus.rest-client.headers]`
 
 

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

@@ -544,6 +544,23 @@ endif::add-copy-button-to-env-var[]
 |
 
 
+a| [[quarkus-rest-client-restclient-config-rest-clients-config_quarkus.rest-client.capture-stacktrace]]`link:#quarkus-rest-client-restclient-config-rest-clients-config_quarkus.rest-client.capture-stacktrace[quarkus.rest-client.capture-stacktrace]`
+
+
+[.description]
+--
+If `true`, the stacktrace of the invocation of the REST Client method is captured. This stacktrace will be used if the invocation throws an exception
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT_CAPTURE_STACKTRACE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT_CAPTURE_STACKTRACE+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|`true`
+
+
 a| [[quarkus-rest-client-restclient-config-rest-clients-config_quarkus.rest-client.-config-key-.multipart.max-chunk-size]]`link:#quarkus-rest-client-restclient-config-rest-clients-config_quarkus.rest-client.-config-key-.multipart.max-chunk-size[quarkus.rest-client."config-key".multipart.max-chunk-size]`
 
 
@@ -1072,6 +1089,23 @@ endif::add-copy-button-to-env-var[]
 |
 
 
+a| [[quarkus-rest-client-restclient-config-rest-clients-config_quarkus.rest-client.-config-key-.capture-stacktrace]]`link:#quarkus-rest-client-restclient-config-rest-clients-config_quarkus.rest-client.-config-key-.capture-stacktrace[quarkus.rest-client."config-key".capture-stacktrace]`
+
+
+[.description]
+--
+If `true`, the stacktrace of the invocation of the REST Client method is captured. This stacktrace will be used if the invocation throws an exception
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|
+
+
 a| [[quarkus-rest-client-restclient-config-rest-clients-config_quarkus.rest-client.headers-headers]]`link:#quarkus-rest-client-restclient-config-rest-clients-config_quarkus.rest-client.headers-headers[quarkus.rest-client.headers]`
 
 

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

@@ -594,4 +594,21 @@ endif::add-copy-button-to-env-var[]
 --|boolean 
 |
 
+
+a| [[quarkus-restclient-config-general-config-items_quarkus.rest-client.-config-key-.capture-stacktrace]]`link:#quarkus-restclient-config-general-config-items_quarkus.rest-client.-config-key-.capture-stacktrace[quarkus.rest-client."config-key".capture-stacktrace]`
+
+
+[.description]
+--
+If `true`, the stacktrace of the invocation of the REST Client method is captured. This stacktrace will be used if the invocation throws an exception
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|
+
 |===

_generated-doc/main/config/quarkus-rest-client-restclient-config-rest-clients-config.adoc

@@ -537,4 +537,21 @@ endif::add-copy-button-to-env-var[]
 --|boolean 
 |
 
+
+a| [[quarkus-restclient-config-rest-client-config_quarkus.rest-client.-config-key-.capture-stacktrace]]`link:#quarkus-restclient-config-rest-client-config_quarkus.rest-client.-config-key-.capture-stacktrace[quarkus.rest-client."config-key".capture-stacktrace]`
+
+
+[.description]
+--
+If `true`, the stacktrace of the invocation of the REST Client method is captured. This stacktrace will be used if the invocation throws an exception
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|
+
 |===

_generated-doc/main/config/quarkus-restclient-config-general-config-items.adoc

@@ -544,6 +544,23 @@ endif::add-copy-button-to-env-var[]
 |
 
 
+a| [[quarkus-restclient-config_quarkus.rest-client.capture-stacktrace]]`link:#quarkus-restclient-config_quarkus.rest-client.capture-stacktrace[quarkus.rest-client.capture-stacktrace]`
+
+
+[.description]
+--
+If `true`, the stacktrace of the invocation of the REST Client method is captured. This stacktrace will be used if the invocation throws an exception
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT_CAPTURE_STACKTRACE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT_CAPTURE_STACKTRACE+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|`true`
+
+
 a| [[quarkus-restclient-config_quarkus.rest-client.-config-key-.multipart.max-chunk-size]]`link:#quarkus-restclient-config_quarkus.rest-client.-config-key-.multipart.max-chunk-size[quarkus.rest-client."config-key".multipart.max-chunk-size]`
 
 
@@ -1072,6 +1089,23 @@ endif::add-copy-button-to-env-var[]
 |
 
 
+a| [[quarkus-restclient-config_quarkus.rest-client.-config-key-.capture-stacktrace]]`link:#quarkus-restclient-config_quarkus.rest-client.-config-key-.capture-stacktrace[quarkus.rest-client."config-key".capture-stacktrace]`
+
+
+[.description]
+--
+If `true`, the stacktrace of the invocation of the REST Client method is captured. This stacktrace will be used if the invocation throws an exception
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT__CONFIG_KEY__CAPTURE_STACKTRACE+++`
+endif::add-copy-button-to-env-var[]
+--|boolean 
+|
+
+
 a| [[quarkus-restclient-config_quarkus.rest-client.headers-headers]]`link:#quarkus-restclient-config_quarkus.rest-client.headers-headers[quarkus.rest-client.headers]`
 
 

_generated-doc/main/config/quarkus-restclient-config-rest-client-config.adoc

@@ -960,7 +960,25 @@ quarkus.kubernetes.rbac.cluster-role-bindings.my-cluster-role-binding.role-name=
 <1> In this example, the cluster role "my-cluster-role" will be generated with the specified policy rules.
 <2> The name of the ClusterRole resource to use. Role resources are namespace-based and hence not allowed in ClusterRoleBinding resources.
 
-=== Deploying to Minikube
+=== Deploying to local Kubernetes
+
+When deploying to local Kubernetes environments, users often perform minor changes to their manifests that simplify the development process.
+The most common changes are:
+
+- Setting `imagePullPolicy` to `IfNotPresent`
+- Using `NodePort` as `Service` type
+
+Quarkus provides extensions that among others set these options by default.
+Such extensions are:
+
+- quarkus-minikube
+- quarkus-kind
+
+If the list of extensions does not match the tool you are using (e.g. Docker Desktop, microk8s etc) then it is suggested to use the `quarkus-minikube` extension.
+as its defaults should be reasonable for most environments.
+
+
+==== Deploying to Minikube
 
 https://github.com/kubernetes/minikube[Minikube] is quite popular when a Kubernetes cluster is needed for development purposes. To make the deployment to Minikube
 experience as frictionless as possible, Quarkus provides the `quarkus-minikube` extension. This extension can be added to a project like so:
@@ -1008,7 +1026,7 @@ only. When deploying to production, consider using the vanilla Kubernetes manife
 NOTE: If the assumptions the Minikube extension makes don't fit your workflow, nothing prevents you from using the regular Kubernetes extension to generate Kubernetes manifests
 and apply those to your Minikube cluster.
 
-=== Deploying to Kind
+==== Deploying to Kind
 https://kind.sigs.k8s.io/[Kind] is another popular tool used as a Kubernetes cluster for development purposes. To make the deployment to Kind
 experience as frictionless as possible, Quarkus provides the `quarkus-kind` extension. This extension can be added to a project like so: