Skip to content

Commit 0cd1218

Browse files
committed
Move Hibernate ORM/Reactive configuration reference to the bottom of the guides
Because: 1. It's super long, it makes no sense to have it in the middle of the guide. 2. Other guides follow this approach as well, so we'd better be consistent.
1 parent 3416d05 commit 0cd1218

File tree

2 files changed

+15
-9
lines changed

2 files changed

+15
-9
lines changed

docs/src/main/asciidoc/hibernate-orm.adoc

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ They will often map to Hibernate ORM configuration properties but could have dif
100100

101101
Also, Quarkus will set many Hibernate ORM configuration settings automatically, and will often use more modern defaults.
102102

103-
For a list of the items that you can set in `{config-file}`, see <<hibernate-configuration-properties,Hibernate ORM configuration properties>>.
103+
For a list of the items that you can set in `{config-file}`, see <<configuration-reference>>.
104104

105105
An `EntityManagerFactory` will be created based on the Quarkus `datasource` configuration as long as the Hibernate ORM extension is listed among your project dependencies.
106106

@@ -295,9 +295,7 @@ There are no required properties, as long as a default datasource is configured.
295295
When no property is set, Quarkus can typically infer everything it needs to set up Hibernate ORM
296296
and will have it use the default datasource.
297297

298-
The configuration properties listed here allow you to override such defaults, and customize and tune various aspects.
299-
300-
include::{generated-dir}/config/quarkus-hibernate-orm.adoc[opts=optional, leveloffset=+2]
298+
The configuration properties listed in <<configuration-reference>> allow you to override such defaults, and customize and tune various aspects.
301299

302300
[NOTE]
303301
====
@@ -961,7 +959,7 @@ quarkus.hibernate-orm."offline".dialect.mariadb.bytes-per-character=1
961959
quarkus.hibernate-orm."offline".dialect.mariadb.no-backslash-escapes=true
962960
----
963961

964-
Refer to the <<hibernate-configuration-properties,Hibernate ORM configuration properties>> section for more details on the available properties.
962+
Refer to the <<configuration-reference>> section for more details on the available properties.
965963

966964

967965
[[caching]]
@@ -1949,3 +1947,8 @@ to learn more about the `dataStore` attribute.
19491947
Please refer to the corresponding https://hibernate.org/repositories/[Hibernate Data Repositories]
19501948
and https://jakarta.ee/specifications/data/1.0/jakarta-data-1.0[Jakarta Data]
19511949
guides to learn what else they have to offer.
1950+
1951+
[[configuration-reference]]
1952+
== Configuration Reference for Hibernate ORM
1953+
1954+
include::{generated-dir}/config/quarkus-hibernate-orm.adoc[opts=optional, leveloffset=+2]

docs/src/main/asciidoc/hibernate-reactive.adoc

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ Blocking (non-reactive) and reactive configuration xref:orm-and-reactive-extensi
116116

117117
WARNING: Configuring Hibernate Reactive using the standard `persistence.xml` configuration file is not supported.
118118

119-
See section <<hr-configuration-properties,Hibernate Reactive configuration properties>> for the list of properties you can set in `{config-file}`.
119+
See section <<configuration-reference>> for the list of properties you can set in `{config-file}`.
120120

121121
A `Mutiny.SessionFactory` will be created based on the Quarkus `datasource` configuration as long as the Hibernate Reactive extension is listed among your project dependencies.
122122

@@ -193,11 +193,9 @@ and will have it use the default datasource.
193193

194194
The configuration properties listed here allow you to override such defaults, and customize and tune various aspects.
195195

196-
Hibernate Reactive uses the same properties you would use for Hibernate ORM. You will notice that some properties
196+
Hibernate Reactive uses the same properties you would use for Hibernate ORM: see <<configuration-reference>>. You will notice that some properties
197197
contain `jdbc` in the name but there is no JDBC in Hibernate Reactive, these are simply legacy property names.
198198

199-
include::{generated-dir}/config/quarkus-hibernate-orm.adoc[opts=optional, leveloffset=+2]
200-
201199
[TIP]
202200
====
203201
Want to start a PostgreSQL server on the side with Docker?
@@ -446,3 +444,8 @@ by providing active record style entities (and repositories) and focuses on maki
446444
To find out more on how the <<quarkus-hibernate-orm_quarkus-hibernate-orm-validation-mode,`quarkus.hibernate-orm.validation.mode` configuration property>>.
447445
influence your Hibernate Reactive application see the xref:hibernate-orm.adoc#validator_integration[corresponding Hibernate ORM guide],
448446
as these modes work the same in both cases.
447+
448+
[[configuration-reference]]
449+
== Configuration Reference for Hibernate Reactive
450+
451+
include::{generated-dir}/config/quarkus-hibernate-orm.adoc[opts=optional, leveloffset=+2]

0 commit comments

Comments
 (0)