Sync web site with Quarkus documentation

quarkusbot · quarkusbot · commit df77c288c7c3 · 2025-02-12T17:43:04.000Z
diff --git a/_generated-doc/latest/config/quarkus-all-config.adoc b/_generated-doc/latest/config/quarkus-all-config.adoc
@@ -60422,10 +60422,10 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Sets the login mode for the connection. Either `NONE`, `DISABLED`, `OPTIONAL`, `REQUIRED` or `XOAUTH2`.
+Sets the login mode for the connection. Either `NONE`, `DISABLED`, `REQUIRED` or `XOAUTH2`.
 
+ - NONE means a login will be attempted if the server supports it and login credentials are set
  - DISABLED means no login will be attempted
- - NONE means a login will be attempted if the server supports in and login credentials are set
  - REQUIRED means that a login will be attempted if the server supports it and the send operation will fail otherwise
  - XOAUTH2 means that a login will be attempted using Google Gmail Oauth2 tokens
 
@@ -61251,10 +61251,10 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Sets the login mode for the connection. Either `NONE`, `DISABLED`, `OPTIONAL`, `REQUIRED` or `XOAUTH2`.
+Sets the login mode for the connection. Either `NONE`, `DISABLED`, `REQUIRED` or `XOAUTH2`.
 
+ - NONE means a login will be attempted if the server supports it and login credentials are set
  - DISABLED means no login will be attempted
- - NONE means a login will be attempted if the server supports in and login credentials are set
  - REQUIRED means that a login will be attempted if the server supports it and the send operation will fail otherwise
  - XOAUTH2 means that a login will be attempted using Google Gmail Oauth2 tokens
 
@@ -68206,7 +68206,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Refresh expired authorization code flow ID or access tokens. If this property is enabled, a refresh token request is performed if the authorization code ID or access token has expired and, if successful, the local session is updated with the new set of tokens. Otherwise, the local session is invalidated and the user redirected to the OpenID Provider to re-authenticate. In this case, the user might not be challenged again if the OIDC provider session is still active. For this option be effective the `authentication.session-age-extension` property should also be set to a nonzero value since the refresh token is currently kept in the user session. This option is valid only when the application is of type `ApplicationType++#++WEB_APP`++}++. This property is enabled if `quarkus.oidc.token.refresh-token-time-skew` is configured, you do not need to enable this property manually in this case.
+Refresh expired authorization code flow ID or access tokens. If this property is enabled, a refresh token request is performed if the authorization code ID or access token has expired and, if successful, the local session is updated with the new set of tokens. Otherwise, the local session is invalidated and the user redirected to the OpenID Provider to re-authenticate. In this case, the user might not be challenged again if the OIDC provider session is still active. For this option be effective the `authentication.session-age-extension` property should also be set to a nonzero value since the refresh token is currently kept in the user session. This option is valid only when the application is of type `ApplicationType++#++WEB_APP`. This property is enabled if `quarkus.oidc.token.refresh-token-time-skew` is configured, you do not need to enable this property manually in this case.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -68284,7 +68284,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Custom HTTP header that contains a bearer token. This option is valid only when the application is of type `ApplicationType++#++SERVICE`++}++.
+Custom HTTP header that contains a bearer token. This option is valid only when the application is of type `ApplicationType++#++SERVICE`.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -86450,7 +86450,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-The exception types that are not considered failures and hence should not trigger fallback. Takes priority over `apply-on()`++}++.
+The exception types that are not considered failures and hence should not trigger fallback. Takes priority over `apply-on()`.
 
 
 ifdef::add-copy-button-to-env-var[]
diff --git a/_generated-doc/latest/config/quarkus-mailer.adoc b/_generated-doc/latest/config/quarkus-mailer.adoc
@@ -596,10 +596,10 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Sets the login mode for the connection. Either `NONE`, `DISABLED`, `OPTIONAL`, `REQUIRED` or `XOAUTH2`.
+Sets the login mode for the connection. Either `NONE`, `DISABLED`, `REQUIRED` or `XOAUTH2`.
 
+ - NONE means a login will be attempted if the server supports it and login credentials are set
  - DISABLED means no login will be attempted
- - NONE means a login will be attempted if the server supports in and login credentials are set
  - REQUIRED means that a login will be attempted if the server supports it and the send operation will fail otherwise
  - XOAUTH2 means that a login will be attempted using Google Gmail Oauth2 tokens
 
@@ -1425,10 +1425,10 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Sets the login mode for the connection. Either `NONE`, `DISABLED`, `OPTIONAL`, `REQUIRED` or `XOAUTH2`.
+Sets the login mode for the connection. Either `NONE`, `DISABLED`, `REQUIRED` or `XOAUTH2`.
 
+ - NONE means a login will be attempted if the server supports it and login credentials are set
  - DISABLED means no login will be attempted
- - NONE means a login will be attempted if the server supports in and login credentials are set
  - REQUIRED means that a login will be attempted if the server supports it and the send operation will fail otherwise
  - XOAUTH2 means that a login will be attempted using Google Gmail Oauth2 tokens
 
diff --git a/_generated-doc/latest/config/quarkus-mailer_quarkus.mailer.adoc b/_generated-doc/latest/config/quarkus-mailer_quarkus.mailer.adoc
@@ -596,10 +596,10 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Sets the login mode for the connection. Either `NONE`, `DISABLED`, `OPTIONAL`, `REQUIRED` or `XOAUTH2`.
+Sets the login mode for the connection. Either `NONE`, `DISABLED`, `REQUIRED` or `XOAUTH2`.
 
+ - NONE means a login will be attempted if the server supports it and login credentials are set
  - DISABLED means no login will be attempted
- - NONE means a login will be attempted if the server supports in and login credentials are set
  - REQUIRED means that a login will be attempted if the server supports it and the send operation will fail otherwise
  - XOAUTH2 means that a login will be attempted using Google Gmail Oauth2 tokens
 
@@ -1425,10 +1425,10 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Sets the login mode for the connection. Either `NONE`, `DISABLED`, `OPTIONAL`, `REQUIRED` or `XOAUTH2`.
+Sets the login mode for the connection. Either `NONE`, `DISABLED`, `REQUIRED` or `XOAUTH2`.
 
+ - NONE means a login will be attempted if the server supports it and login credentials are set
  - DISABLED means no login will be attempted
- - NONE means a login will be attempted if the server supports in and login credentials are set
  - REQUIRED means that a login will be attempted if the server supports it and the send operation will fail otherwise
  - XOAUTH2 means that a login will be attempted using Google Gmail Oauth2 tokens
 
diff --git a/_generated-doc/latest/config/quarkus-oidc.adoc b/_generated-doc/latest/config/quarkus-oidc.adoc
@@ -2087,7 +2087,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Refresh expired authorization code flow ID or access tokens. If this property is enabled, a refresh token request is performed if the authorization code ID or access token has expired and, if successful, the local session is updated with the new set of tokens. Otherwise, the local session is invalidated and the user redirected to the OpenID Provider to re-authenticate. In this case, the user might not be challenged again if the OIDC provider session is still active. For this option be effective the `authentication.session-age-extension` property should also be set to a nonzero value since the refresh token is currently kept in the user session. This option is valid only when the application is of type `ApplicationType++#++WEB_APP`++}++. This property is enabled if `quarkus.oidc.token.refresh-token-time-skew` is configured, you do not need to enable this property manually in this case.
+Refresh expired authorization code flow ID or access tokens. If this property is enabled, a refresh token request is performed if the authorization code ID or access token has expired and, if successful, the local session is updated with the new set of tokens. Otherwise, the local session is invalidated and the user redirected to the OpenID Provider to re-authenticate. In this case, the user might not be challenged again if the OIDC provider session is still active. For this option be effective the `authentication.session-age-extension` property should also be set to a nonzero value since the refresh token is currently kept in the user session. This option is valid only when the application is of type `ApplicationType++#++WEB_APP`. This property is enabled if `quarkus.oidc.token.refresh-token-time-skew` is configured, you do not need to enable this property manually in this case.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -2165,7 +2165,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Custom HTTP header that contains a bearer token. This option is valid only when the application is of type `ApplicationType++#++SERVICE`++}++.
+Custom HTTP header that contains a bearer token. This option is valid only when the application is of type `ApplicationType++#++SERVICE`.
 
 
 ifdef::add-copy-button-to-env-var[]
diff --git a/_generated-doc/latest/config/quarkus-oidc_quarkus.oidc.adoc b/_generated-doc/latest/config/quarkus-oidc_quarkus.oidc.adoc
@@ -2087,7 +2087,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Refresh expired authorization code flow ID or access tokens. If this property is enabled, a refresh token request is performed if the authorization code ID or access token has expired and, if successful, the local session is updated with the new set of tokens. Otherwise, the local session is invalidated and the user redirected to the OpenID Provider to re-authenticate. In this case, the user might not be challenged again if the OIDC provider session is still active. For this option be effective the `authentication.session-age-extension` property should also be set to a nonzero value since the refresh token is currently kept in the user session. This option is valid only when the application is of type `ApplicationType++#++WEB_APP`++}++. This property is enabled if `quarkus.oidc.token.refresh-token-time-skew` is configured, you do not need to enable this property manually in this case.
+Refresh expired authorization code flow ID or access tokens. If this property is enabled, a refresh token request is performed if the authorization code ID or access token has expired and, if successful, the local session is updated with the new set of tokens. Otherwise, the local session is invalidated and the user redirected to the OpenID Provider to re-authenticate. In this case, the user might not be challenged again if the OIDC provider session is still active. For this option be effective the `authentication.session-age-extension` property should also be set to a nonzero value since the refresh token is currently kept in the user session. This option is valid only when the application is of type `ApplicationType++#++WEB_APP`. This property is enabled if `quarkus.oidc.token.refresh-token-time-skew` is configured, you do not need to enable this property manually in this case.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -2165,7 +2165,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Custom HTTP header that contains a bearer token. This option is valid only when the application is of type `ApplicationType++#++SERVICE`++}++.
+Custom HTTP header that contains a bearer token. This option is valid only when the application is of type `ApplicationType++#++SERVICE`.
 
 
 ifdef::add-copy-button-to-env-var[]
diff --git a/_generated-doc/latest/config/quarkus-smallrye-fault-tolerance.adoc b/_generated-doc/latest/config/quarkus-smallrye-fault-tolerance.adoc
@@ -645,7 +645,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-The exception types that are not considered failures and hence should not trigger fallback. Takes priority over `apply-on()`++}++.
+The exception types that are not considered failures and hence should not trigger fallback. Takes priority over `apply-on()`.
 
 
 ifdef::add-copy-button-to-env-var[]
diff --git a/_generated-doc/latest/config/quarkus-smallrye-fault-tolerance_quarkus.fault-tolerance.adoc b/_generated-doc/latest/config/quarkus-smallrye-fault-tolerance_quarkus.fault-tolerance.adoc
@@ -645,7 +645,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-The exception types that are not considered failures and hence should not trigger fallback. Takes priority over `apply-on()`++}++.
+The exception types that are not considered failures and hence should not trigger fallback. Takes priority over `apply-on()`.
 
 
 ifdef::add-copy-button-to-env-var[]
diff --git a/_generated-doc/latest/infra/quarkus-all-build-items.adoc b/_generated-doc/latest/infra/quarkus-all-build-items.adoc
@@ -9093,6 +9093,10 @@ _No Javadoc found_
 
 _No Javadoc found_
 
+`java.lang.String absolutePath` 
+
+_No Javadoc found_
+
 `io.quarkus.vertx.http.deployment.devmode.ConfiguredPathInfo configuredPathInfo` 
 
 _No Javadoc found_
diff --git a/_guides/_attributes.adoc b/_guides/_attributes.adoc
@@ -1,7 +1,7 @@
 // Common attributes.
 // --> No blank lines (it ends the document header)
 :project-name: Quarkus
-:quarkus-version: 3.18.2
+:quarkus-version: 3.18.3
 :quarkus-platform-groupid: io.quarkus.platform
 // .
 :maven-version: 3.9.9
@@ -19,7 +19,7 @@
 :logstash-image: docker.io/elastic/logstash:8.15.0
 :kibana-image: docker.io/elastic/kibana:8.15.0
 :keycloak-docker-image: quay.io/keycloak/keycloak:26.0.7
-:jandex-version: 3.2.3
+:jandex-version: 3.2.6
 :jandex-gradle-plugin-version: 1.0.0
 :kotlin-version: 2.0.21
 :grpc-version: 1.69.1
diff --git a/_guides/building-native-image.adoc b/_guides/building-native-image.adoc
@@ -589,7 +589,7 @@ COPY --chown=quarkus:quarkus .mvn /code/.mvn
 COPY --chown=quarkus:quarkus pom.xml /code/
 USER quarkus
 WORKDIR /code
-RUN ./mvnw -B org.apache.maven.plugins:maven-dependency-plugin:3.1.2:go-offline
+RUN ./mvnw -B org.apache.maven.plugins:maven-dependency-plugin:3.8.1:go-offline
 COPY src /code/src
 RUN ./mvnw package -Dnative
 
@@ -724,7 +724,7 @@ RUN mkdir /musl && \
 ENV PATH="/musl/bin:${PATH}"
 USER quarkus
 WORKDIR /code
-RUN ./mvnw -B org.apache.maven.plugins:maven-dependency-plugin:3.1.2:go-offline
+RUN ./mvnw -B org.apache.maven.plugins:maven-dependency-plugin:3.8.1:go-offline
 COPY src /code/src
 RUN ./mvnw package -Dnative -DskipTests -Dquarkus.native.additional-build-args="--static","--libc=musl"
 
diff --git a/_guides/kafka-dev-services.adoc b/_guides/kafka-dev-services.adoc
@@ -52,7 +52,7 @@ Note that the Kafka advertised address is automatically configured with the chos
 [[configuring-the-image]]
 == Configuring the image
 
-Dev Services for Kafka supports https://redpanda.com[Redpanda], https://github/ozangunalp/kafka-native[kafka-native]
+Dev Services for Kafka supports https://redpanda.com[Redpanda], https://github.com/ozangunalp/kafka-native[kafka-native]
 and https://strimzi.io[Strimzi] (in https://github.com/apache/kafka/blob/trunk/config/kraft/README.md[Kraft] mode)  images.
 
 **Redpanda** is a Kafka compatible event streaming platform.
diff --git a/_guides/qute-reference.adoc b/_guides/qute-reference.adoc
@@ -1190,7 +1190,7 @@ In this case, just add `_isolated=false` or `_unisolated` argument to the call s
 ===== Arguments
 
 Named arguments can be accessed directly in the tag template.
-However, the first argument does not need to define a name and it can be accessed using the `it` alias.
+However, the first argument does not need to define a name, and it can be accessed using the `it` alias.
 Furthermore, if an argument does not have a name defined and the value is a single identifier, such as `foo`, then the name is defaulted to the value identifier, e.g. `{#myTag foo /}` becomes `{#myTag foo=foo /}`.
 In other words, the argument value `foo` is resolved and can be accessed using `{foo}` in the tag template.
 
@@ -2044,8 +2044,8 @@ public class ItemResource {
 You can also define a type-safe <<fragments,fragment>> in your Java code.
 A _native static_ method with the name that contains a dollar sign `$` denotes a method that represents a fragment of a type-safe template.
 The name of the fragment is derived from the annotated method name.
-The part before the last occurence of a dollar sign `$` is the method name of the related type-safe template.
-The part after the last occurence of a dollar sign is the fragment identifier.
+The part before the last occurrence of a dollar sign `$` is the method name of the related type-safe template.
+The part after the last occurrence of a dollar sign is the fragment identifier.
 The strategy defined by the relevant `CheckedTemplate#defaultName()` is honored when constructing the defaulted names.
 
 .Type-safe Fragment Example
@@ -2200,18 +2200,18 @@ static BigDecimal discountedPrice(Item item) {
 }
 ----
 
-A special constant - `TemplateExtension#ANY`/`*` - can be used to specify that the extension method matches any name.
+A special constant - `TemplateExtension#ANY` - can be used to specify that the extension method matches any name.
 
 .`TemplateExtension#ANY` Example
 [source,java]
 ----
-@TemplateExtension(matchName = "*")
+@TemplateExtension(matchName = TemplateExtension.ANY)
 static String itemProperty(Item item, String name) { <1>
    // this method matches {item.foo} if "item" resolves to an object assignable to "Item"
    // the value of the "name" argument is "foo"
 }
 ----
-<1> A additional string method parameter is used to pass the actual property name.
+<1> An additional string method parameter is used to pass the actual property name.
 
 It's also possible to match the name against a regular expression specified in `matchRegex()`.
 
@@ -2224,7 +2224,7 @@ static String itemProperty(Item item, String name) { <1>
    // the value of the "name" argument is "foo" or "bar"
 }
 ----
-<1> A additional string method parameter is used to pass the actual property name.
+<1> An additional string method parameter is used to pass the actual property name.
 
 Finally, `matchNames()` can be used to specify a collection of matching names.
 An additional string method parameter is mandatory as well.
@@ -2832,7 +2832,7 @@ In the development mode, all files located in `src/main/resources/templates` are
 By default, a template modification results in an application restart that also triggers build-time validations.
 
 However, it's possible to use the `quarkus.qute.dev-mode.no-restart-templates` configuration property to specify the templates for which the application is not restarted.
-The configration value is a regular expression that matches the template path relative from the `templates` directory and `/` is used as a path separator.
+The configuration value is a regular expression that matches the template path relative from the `templates` directory and `/` is used as a path separator.
 For example, `quarkus.qute.dev-mode.no-restart-templates=templates/foo.html` matches the template `src/main/resources/templates/foo.html`.
 The matching templates are reloaded and only runtime validations are performed.
 
@@ -2938,7 +2938,7 @@ However, the `io.quarkus.qute.i18n.MessageBundle#locale()` can be used to specif
 Additionally, there are two ways to define a localized bundle:
 
 1. Create an interface that extends the default interface that is annotated with `@Localized`
-2. Create an UTF-8 encoded file located in the `src/main/resources/messages` directory of an application archive; e.g. `msg_de.properties`.
+2. Create a UTF-8 encoded file located in the `src/main/resources/messages` directory of an application archive; e.g. `msg_de.properties`.
 
 TIP: While a localized interface enables easy refactoring, an external file might be more convenient in many situations.
 
diff --git a/_guides/scheduler-reference.adoc b/_guides/scheduler-reference.adoc
@@ -382,11 +382,11 @@ class Jobs {
 
 In some cases, it might be useful to choose a scheduler implementation used to execute a scheduled method.
 However, only one `Scheduler` implementation is used for all scheduled methods by default.
-For example, the `quarkus-quartz` extension provides an implementation that supports clustering but it also removes the simple in-memory implementation from the game.
+For example, the `quarkus-quartz` extension provides an implementation that supports clustering, but it also removes the simple in-memory implementation from the game.
 Now, if clustering is enabled then it's not possible to define a scheduled method that would be executed locally on a single node.
 Nevertheless, if you set the `quarkus.scheduler.use-composite-scheduler` config property to `true` then a composite `Scheduler` is used instead.
 This means that multiple scheduler implementations are kept running side by side.
-Furthermore, it's possible to chose a specific implementation used to execute a scheduled method using `@Scheduled#executeWith()`.
+Furthermore, it's possible to choose a specific implementation used to execute a scheduled method using `@Scheduled#executeWith()`.
 
 [source,java]
 ----
diff --git a/_guides/vertx-reference.adoc b/_guides/vertx-reference.adoc
