Sync documentation of main branch

Author: actions-user

_generated-doc/main/config/all-configuration-groups-generated-doc/io.quarkus.hibernate.orm.deployment.HibernateOrmConfigPersistenceUnit

@@ -1 +1 @@
-[{"configDocKey":{"type":"string","key":"","additionalKeys":[],"configDoc":"Class name of the Hibernate ORM dialect.\n\nThe complete list of bundled dialects is available in the\nhttps://docs.jboss.org/hibernate/stable/orm/javadocs/org/hibernate/dialect/package-summary.html[Hibernate ORM\nJavaDoc].\n\nSetting the dialect directly is only recommended as a last resort:\nmost popular databases have a corresponding Quarkus extension,\nallowing Quarkus to select the dialect automatically,\nin which case you do not need to set the dialect at all,\nthough you may want to set\nxref:datasource.adoc#quarkus-datasource_quarkus.datasource.db-version[`quarkus.datasource.db-version`] as\nhigh as possible\nto benefit from the best performance and latest features.\n\nIf your database does not have a corresponding Quarkus extension,\nyou will need to set the dialect directly.\nIn that case, keep in mind that the JDBC driver and Hibernate ORM dialect\nmay not work properly in GraalVM native executables.","withinAMap":false,"defaultValue":"selected automatically for most popular databases","javaDocSiteLink":"","docMapKey":"dialect","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"withinAConfigGroup":true,"topLevelGrouping":"","since":null,"environmentVariable":"","enum":false}},{"configDocKey":{"type":"string","key":".storage-engine","additionalKeys":[],"configDoc":"The storage engine to use when the dialect supports multiple storage engines.\n\nE.g. `MyISAM` or `InnoDB` for MySQL.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"storage-engine","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"withinAConfigGroup":true,"topLevelGrouping":"","since":null,"environmentVariable":"_STORAGE_ENGINE","enum":false}}]
+[{"configDocKey":{"type":"string","key":"","additionalKeys":[],"configDoc":"Name of the Hibernate ORM dialect.\n\nFor xref:datasource.adoc#extensions-and-database-drivers-reference[supported databases],\nthis property does not need to be set explicitly:\nit is selected automatically based on the datasource,\nand configured using the xref:datasource.adoc#quarkus-datasource_quarkus.datasource.db-version[DB version set on the\ndatasource]\nto benefit from the best performance and latest features.\n\nIf your database does not have a corresponding Quarkus extension,\nyou *will* need to set this property explicitly.\nIn that case, keep in mind that the JDBC driver and Hibernate ORM dialect\nmay not work properly in GraalVM native executables.\n\nFor built-in dialects, the expected value is one of the names\nin the link:{hibernate-orm-dialect-docs-url}[official list of dialects],\n*without* the `Dialect` suffix,\nfor example `Cockroach` for `CockroachDialect`.\n\nFor third-party dialects, the expected value is the fully-qualified class name,\nfor example `com.acme.hibernate.AcmeDbDialect`.","withinAMap":false,"defaultValue":"selected automatically for most popular databases","javaDocSiteLink":"","docMapKey":"dialect","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"withinAConfigGroup":true,"topLevelGrouping":"","since":null,"environmentVariable":"","enum":false}},{"configDocKey":{"type":"string","key":".storage-engine","additionalKeys":[],"configDoc":"The storage engine to use when the dialect supports multiple storage engines.\n\nE.g. `MyISAM` or `InnoDB` for MySQL.","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"storage-engine","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":false,"withinAConfigGroup":true,"topLevelGrouping":"","since":null,"environmentVariable":"_STORAGE_ENGINE","enum":false}}]

_generated-doc/main/config/all-configuration-groups-generated-doc/io.quarkus.hibernate.orm.deployment.HibernateOrmConfigPersistenceUnit.HibernateOrmConfigPersistenceUnitDialect

@@ -1 +1 @@
-[{"configDocKey":{"type":"string","key":".configurer","additionalKeys":[],"configDoc":"One or more xref:hibernate-search-standalone-elasticsearch.adoc#bean-reference-note-anchor[bean references]\nto the component(s) used to configure the Hibernate Search mapping,\nin particular programmatically.\n\nThe referenced beans must implement `StandalonePojoMappingConfigurer`.\n\nSee xref:hibernate-search-standalone-elasticsearch.adoc#programmatic-mapping[Programmatic mapping] for an example\non how mapping configurers can be used to apply programmatic mappings.\n\n[NOTE]\n====\nInstead of setting this configuration property,\nyou can simply annotate your custom `StandalonePojoMappingConfigurer` implementations with `@SearchExtension`\nand leave the configuration property unset: Hibernate Search will use the annotated implementation automatically.\nSee xref:hibernate-search-standalone-elasticsearch.adoc#plugging-in-custom-components[this section]\nfor more information.\n\nIf this configuration property is set, it takes precedence over any `@SearchExtension` annotation.\n====","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"configurer","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":true,"withinAConfigGroup":true,"topLevelGrouping":"","since":null,"environmentVariable":"_CONFIGURER","enum":false}},{"configDocKey":{"type":"io.quarkus.hibernate.search.standalone.elasticsearch.runtime.MappingStructure","key":".structure","additionalKeys":[],"configDoc":"The structure of the Hibernate Search entity mapping.\n\nThis must match the structure of the application model being indexed with Hibernate Search:\n\n`graph` (default)::\nEntities indexed through Hibernate Search are nodes in an entity graph,\ni.e. an indexed entity is independent of other entities it references through associations,\nwhich *can* be updated independently of the indexed entity.\n+\nAssociations between entities must be bi-directional:\nspecifying the inverse side of associations through `@AssociationInverseSide` *is required*,\nunless reindexing is disabled for that association through `@IndexingDependency(reindexOnUpdate = ...)`.\n`tree`::\nEntities indexed through Hibernate Search are the root of a document,\ni.e. an indexed entity \"owns\" other entities it references through associations,\nwhich *cannot* be updated independently of the indexed entity.\n+\nAssociations between entities can be uni-directional:\nspecifying the inverse side of associations through `@AssociationInverseSide` *is not required*.\n\nSee also link:{hibernate-search-docs-url}#mapping-reindexing-associationinverseside[`@AssociationInverseSide`]\nlink:{hibernate-search-docs-url}#mapping-reindexing-reindexonupdate[`@IndexingDependency(reindexOnUpdate = ...)`].","withinAMap":false,"defaultValue":"graph","javaDocSiteLink":"","docMapKey":"structure","configPhase":"BUILD_TIME","acceptedValues":["`graph`","`document`"],"optional":false,"list":false,"withinAConfigGroup":true,"topLevelGrouping":"","since":null,"environmentVariable":"_STRUCTURE","enum":true}}]
+[{"configDocKey":{"type":"string","key":".configurer","additionalKeys":[],"configDoc":"One or more xref:hibernate-search-standalone-elasticsearch.adoc#bean-reference-note-anchor[bean references]\nto the component(s) used to configure the Hibernate Search mapping,\nin particular programmatically.\n\nThe referenced beans must implement `StandalonePojoMappingConfigurer`.\n\nSee xref:hibernate-search-standalone-elasticsearch.adoc#programmatic-mapping[Programmatic mapping] for an example\non how mapping configurers can be used to apply programmatic mappings.\n\n[NOTE]\n====\nInstead of setting this configuration property,\nyou can simply annotate your custom `StandalonePojoMappingConfigurer` implementations with `@SearchExtension`\nand leave the configuration property unset: Hibernate Search will use the annotated implementation automatically.\nSee xref:hibernate-search-standalone-elasticsearch.adoc#plugging-in-custom-components[this section]\nfor more information.\n\nIf this configuration property is set, it takes precedence over any `@SearchExtension` annotation.\n====","withinAMap":false,"defaultValue":"","javaDocSiteLink":"","docMapKey":"configurer","configPhase":"BUILD_TIME","acceptedValues":null,"optional":true,"list":true,"withinAConfigGroup":true,"topLevelGrouping":"","since":null,"environmentVariable":"_CONFIGURER","enum":false}},{"configDocKey":{"type":"io.quarkus.hibernate.search.standalone.elasticsearch.runtime.MappingStructure","key":".structure","additionalKeys":[],"configDoc":"The structure of the Hibernate Search entity mapping.\n\nThis must match the structure of the application model being indexed with Hibernate Search:\n\n`graph` (default)::\nEntities indexed through Hibernate Search are nodes in an entity graph,\ni.e. an indexed entity is independent of other entities it references through associations,\nwhich *can* be updated independently of the indexed entity.\n+\nAssociations between entities must be bi-directional:\nspecifying the inverse side of associations through `@AssociationInverseSide` *is required*,\nunless reindexing is disabled for that association through `@IndexingDependency(reindexOnUpdate = ...)`.\n`document`::\nEntities indexed through Hibernate Search are the root of a document,\ni.e. an indexed entity \"owns\" other entities it references through associations,\nwhich *cannot* be updated independently of the indexed entity.\n+\nAssociations between entities can be uni-directional:\nspecifying the inverse side of associations through `@AssociationInverseSide` *is not required*.\n\nSee also link:{hibernate-search-docs-url}#mapping-reindexing-associationinverseside[`@AssociationInverseSide`]\nlink:{hibernate-search-docs-url}#mapping-reindexing-reindexonupdate[`@IndexingDependency(reindexOnUpdate = ...)`].","withinAMap":false,"defaultValue":"graph","javaDocSiteLink":"","docMapKey":"structure","configPhase":"BUILD_TIME","acceptedValues":["`graph`","`document`"],"optional":false,"list":false,"withinAConfigGroup":true,"topLevelGrouping":"","since":null,"environmentVariable":"_STRUCTURE","enum":true}}]

_generated-doc/main/config/all-configuration-groups-generated-doc/io.quarkus.hibernate.search.standalone.elasticsearch.runtime.HibernateSearchStandaloneBuildTimeConfig.MappingConfig

@@ -83,7 +83,7 @@ a| `Holder holder` :: +++<i>No Javadoc found</i>+++
 a| https://github.com/quarkusio/quarkus/blob/main/core/deployment/src/main/java/io/quarkus/deployment/builditem/BytecodeRecorderObjectLoaderBuildItem.java[`io.quarkus.deployment.builditem.BytecodeRecorderObjectLoaderBuildItem`, window="_blank"] :: ++++++
 a| `ObjectLoader objectLoader` :: +++<i>No Javadoc found</i>+++
 
-a| https://github.com/quarkusio/quarkus/blob/main/core/deployment/src/main/java/io/quarkus/deployment/builditem/BytecodeTransformerBuildItem.java[`io.quarkus.deployment.builditem.BytecodeTransformerBuildItem`, window="_blank"] :: +++<i>No Javadoc found</i>+++
+a| https://github.com/quarkusio/quarkus/blob/main/core/deployment/src/main/java/io/quarkus/deployment/builditem/BytecodeTransformerBuildItem.java[`io.quarkus.deployment.builditem.BytecodeTransformerBuildItem`, window="_blank"] :: +++Transform a class using ASM . Note that the transformation is performed after assembling the index and thus the changes won't be visible to any processor steps relying on the index. <p> You may consider using  if your transformation should be visible for Arc. See also <a href="https://quarkus.io/version/main/guides/cdi-integration#annotations_transformer_build_item">I Need To Transform Annotation Metadata</a> section of Quarkus CDI integration guide.+++
 a| `String classToTransform` :: +++<i>No Javadoc found</i>+++
 `BiFunction visitorFunction` :: +++<i>No Javadoc found</i>+++
 `BiFunction inputTransformer` :: +++Function that can be applied to the input bytes before it is passed into ASM. This should only be used in very specific circumstances. At the moment the only known valid use case is JaCoCo, which needs access to the unmodified class file bytes.+++

_generated-doc/main/config/all-configuration-roots-generated-doc/io.quarkus.hibernate.orm.deployment.HibernateOrmConfig

@@ -14620,26 +14620,28 @@ a|icon:lock[title=Fixed at build time] [[quarkus-hibernate-orm_quarkus-hibernate
 
 [.description]
 --
-Class name of the Hibernate ORM dialect.
+Name of the Hibernate ORM dialect.
 
-The complete list of bundled dialects is available in the
-https://docs.jboss.org/hibernate/stable/orm/javadocs/org/hibernate/dialect/package-summary.html[Hibernate ORM
-JavaDoc].
-
-Setting the dialect directly is only recommended as a last resort:
-most popular databases have a corresponding Quarkus extension,
-allowing Quarkus to select the dialect automatically,
-in which case you do not need to set the dialect at all,
-though you may want to set
-xref:datasource.adoc#quarkus-datasource_quarkus.datasource.db-version[`quarkus.datasource.db-version`] as
-high as possible
+For xref:datasource.adoc#extensions-and-database-drivers-reference[supported databases],
+this property does not need to be set explicitly:
+it is selected automatically based on the datasource,
+and configured using the xref:datasource.adoc#quarkus-datasource_quarkus.datasource.db-version[DB version set on the
+datasource]
 to benefit from the best performance and latest features.
 
 If your database does not have a corresponding Quarkus extension,
-you will need to set the dialect directly.
+you *will* need to set this property explicitly.
 In that case, keep in mind that the JDBC driver and Hibernate ORM dialect
 may not work properly in GraalVM native executables.
 
+For built-in dialects, the expected value is one of the names
+in the link:{hibernate-orm-dialect-docs-url}[official list of dialects],
+*without* the `Dialect` suffix,
+for example `Cockroach` for `CockroachDialect`.
+
+For third-party dialects, the expected value is the fully-qualified class name,
+for example `com.acme.hibernate.AcmeDbDialect`.
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_HIBERNATE_ORM_DIALECT+++[]
 endif::add-copy-button-to-env-var[]
@@ -17509,7 +17511,7 @@ which *can* be updated independently of the indexed entity.
 Associations between entities must be bi-directional:
 specifying the inverse side of associations through `@AssociationInverseSide` *is required*,
 unless reindexing is disabled for that association through `@IndexingDependency(reindexOnUpdate = ...)`.
-`tree`::
+`document`::
 Entities indexed through Hibernate Search are the root of a document,
 i.e. an indexed entity "owns" other entities it references through associations,
 which *cannot* be updated independently of the indexed entity.

_generated-doc/main/config/all-configuration-roots-generated-doc/io.quarkus.hibernate.search.standalone.elasticsearch.runtime.HibernateSearchStandaloneBuildTimeConfig

@@ -94,6 +94,25 @@ endif::add-copy-button-to-env-var[]
 |`false`
 
 
+a| [[quarkus-core_quarkus-args]]`link:#quarkus-core_quarkus-args[quarkus.args]`
+
+
+[.description]
+--
+The arguments passed to the command line.
+
+We don't make it a list as the args are separated by a space, not a comma.
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_ARGS+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_ARGS+++`
+endif::add-copy-button-to-env-var[]
+--|string 
+|
+
+
 a| [[quarkus-core_quarkus-profile]]`link:#quarkus-core_quarkus-profile[quarkus.profile]`
 
 
@@ -199,25 +218,6 @@ endif::add-copy-button-to-env-var[]
 |
 
 
-a| [[quarkus-core_quarkus-args]]`link:#quarkus-core_quarkus-args[quarkus.args]`
-
-
-[.description]
---
-The arguments passed to the command line.
-
-We don't make it a list as the args are separated by a space, not a comma.
-
-ifdef::add-copy-button-to-env-var[]
-Environment variable: env_var_with_copy_button:+++QUARKUS_ARGS+++[]
-endif::add-copy-button-to-env-var[]
-ifndef::add-copy-button-to-env-var[]
-Environment variable: `+++QUARKUS_ARGS+++`
-endif::add-copy-button-to-env-var[]
---|string 
-|
-
-
 a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus-analytics-disabled]]`link:#quarkus-core_quarkus-analytics-disabled[quarkus.analytics.disabled]`