Rely on globally configured root-project-dir / fix paths and duplicated references

marko-bekhta · marko-bekhta · commit e399d77752ac · 2025-09-29T11:28:38.000+02:00
diff --git a/documentation/src/main/asciidoc/topical/logging/Logging.adoc b/documentation/src/main/asciidoc/topical/logging/Logging.adoc
@@ -1,11 +1,11 @@
-:shared-attributes-dir: ../../shared
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/common-attributes.adoc[]
 include::{shared-attributes-dir}/url-attributes.adoc[]
 include::{shared-attributes-dir}/filesystem-attributes.adoc[]
 include::{shared-attributes-dir}/renderer-attributes.adoc[]
 
-:jboss-logging-url:
+:jboss-logging-url: https://github.com/jboss-logging
 
 [[root]]
 = Logging
diff --git a/documentation/src/main/asciidoc/userguide/appendices/LegacyBasicTypeResolution.adoc b/documentation/src/main/asciidoc/userguide/appendices/LegacyBasicTypeResolution.adoc
@@ -1,4 +1,3 @@
-:root-project-dir: ../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :sourcedir: {core-project-dir}/src/test/java/org/hibernate/orm/test/mapping
 :extrasdir: extras
@@ -319,4 +318,4 @@ When running the previous test case against the `BitSetUserType` entity mapping,
 ----
 include::{originalextrasdir}/basic/basic-custom-type-BitSetUserType-persistence-sql-example.sql[]
 ----
-====
+====
diff --git a/documentation/src/main/asciidoc/userguide/chapters/batch/Batching.adoc b/documentation/src/main/asciidoc/userguide/chapters/batch/Batching.adoc
@@ -1,6 +1,5 @@
 [[batch]]
 == Batching
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-doc-batch: {core-project-dir}/src/test/java/org/hibernate/orm/test/batch
 :example-dir-bulkid: {core-project-dir}/src/test/java/org/hibernate/orm/test/bulkid
diff --git a/documentation/src/main/asciidoc/userguide/chapters/bootstrap/Bootstrap.adoc b/documentation/src/main/asciidoc/userguide/chapters/bootstrap/Bootstrap.adoc
@@ -4,7 +4,6 @@
 :asciidoc-dir: ../../..
 include::{asciidoc-dir}/shared/common-attributes.adoc[]
 
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :core-test-base: {core-project-dir}/src/test/java/org/hibernate/orm/test
 :example-dir-boot: {core-test-base}/bootstrap
diff --git a/documentation/src/main/asciidoc/userguide/chapters/caching/Caching.adoc b/documentation/src/main/asciidoc/userguide/chapters/caching/Caching.adoc
@@ -1,6 +1,5 @@
 [[caching]]
 == Caching
-:root-project-dir: ../../../../../../..
 :jcache-project-dir: {root-project-dir}/hibernate-jcache
 :example-dir-caching: {jcache-project-dir}/src/test/java/org/hibernate/orm/test/caching
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/access.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/access.adoc
@@ -1,6 +1,5 @@
 [[access]]
 === Access strategies
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-access: {core-project-dir}/src/test/java/org/hibernate/orm/test/mapping/access
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/associations.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/associations.adoc
@@ -1,6 +1,5 @@
 [[associations]]
 === Associations
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-association: {core-project-dir}/src/test/java/org/hibernate/orm/test/associations
 :example-dir-any: {core-project-dir}/src/test/java/org/hibernate/orm/test/any
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/basic_types.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/basic_types.adoc
@@ -1,6 +1,5 @@
 [[basic]]
 === Basic values
-:root-project-dir: ../../../../../../..
 :testing-project-dir: {root-project-dir}/hibernate-testing
 :example-dir-model: {testing-project-dir}/src/main/java/org/hibernate/testing/orm/domain/userguide
 :core-project-dir: {root-project-dir}/hibernate-core
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/collections.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/collections.adoc
@@ -1,6 +1,5 @@
 [[collections]]
 === Collections
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :core-test-base: {core-project-dir}/src/test/java
 :example-dir-collection: {core-test-base}/org/hibernate/orm/test/mapping/collections
@@ -241,7 +240,7 @@ include::{example-dir-collection}/classification/map/EntityWithSortedMap.java[ta
 
 
 
-[[collections-bag]]
+[[collections-mapping]]
 ==== Mapping Collections
 
 Without any other mapping influencers, `java.util.Collection` is interpreted using BAG
@@ -786,7 +785,7 @@ include::{extrasdir}/collections-customizing-ordered-by-sql-clause-fetching-exam
 ----
 ====
 
-[[collections-set]]
+[[collections-set-types]]
 ==== Sets
 
 Sets are collections that don't allow duplicate entries and Hibernate supports both the unordered `Set` and the natural-ordering `SortedSet`.
@@ -885,7 +884,7 @@ Before v6, `@SortNatural` must be used if collection element's natural ordering
 Starting from v6, we can omit `@SortNatural` as it will take effect by default.
 ====
 
-[[collections-map]]
+[[collections-map-types]]
 ==== Maps
 
 A `java.util.Map` is a ternary association because it requires a parent entity, a map key, and a value.
@@ -1080,7 +1079,7 @@ include::{extrasdir}/collections-map-bidirectional-example.sql[]
 ----
 ====
 
-[[collections-array]]
+[[collections-array-types]]
 ==== Arrays
 
 When discussing arrays, it is important to understand the distinction between SQL array types and Java arrays that are mapped as part of the application's domain model.
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/customizing.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/customizing.adoc
@@ -1,6 +1,5 @@
 [[domain-customizing]]
 === Customizing the domain model
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-attributebinder: {core-project-dir}/src/test/java/org/hibernate/orm/test/mapping/attributebinder
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/dynamic_model.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/dynamic_model.adoc
@@ -1,6 +1,5 @@
 [[dynamic-model]]
 === Dynamic Model
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-dynamic: {core-project-dir}/src/test/java/org/hibernate/orm/test/mapping/dynamic
 :example-dir-resources: {core-project-dir}/src/test/resources/org/hibernate/orm/test/mapping/dynamic
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/embeddables.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/embeddables.adoc
@@ -1,6 +1,5 @@
 [[embeddables]]
 === Embeddable values
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :core-test-base: {root-project-dir}/hibernate-core/src/test/java
 :example-dir-emeddable: {core-test-base}/org/hibernate/orm/test/mapping/embeddable
@@ -764,4 +763,4 @@ Again, the name and the nullability of the `aggregate` column can be refined thr
 Mapping <<chapters/domain/collections.adoc#collections,collections>> inside an `@Embeddable` value is supported in most cases. There are a couple exceptions:
 
 * If the values of an <<chapters/domain/collections.adoc#collections-elemental,@ElementCollection>> is of embeddable type, that embeddable cannot contain nested collections;
-* Explicitly selecting an embeddable that contains collections in a query is currently not supported (we wouldn't be able to correctly initialize the collection since its owning entity instance would be missing from the Persistence Context).
+* Explicitly selecting an embeddable that contains collections in a query is currently not supported (we wouldn't be able to correctly initialize the collection since its owning entity instance would be missing from the Persistence Context).
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/entity.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/entity.adoc
@@ -1,6 +1,5 @@
 ﻿[[entity]]
 === Entity types
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :core-test-base: {core-project-dir}/src/test/java/org/hibernate/orm/test
 :example-dir-mapping: {core-test-base}/mapping
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/identifiers.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/identifiers.adoc
@@ -1,6 +1,5 @@
 [[identifiers]]
 === Identifiers
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :core-test-base: {core-project-dir}/src/test/java/org/hibernate/orm/test
 :example-dir-identifier: {core-test-base}/mapping/identifier
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/immutability.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/immutability.adoc
@@ -1,6 +1,5 @@
 [[mutability]]
 === Mutability
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :mutability-example-dir: {core-project-dir}/src/test/java/org/hibernate/orm/test/mapping/mutability
 :extrasdir: extras/immutability
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/inheritance.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/inheritance.adoc
@@ -1,6 +1,5 @@
 [[entity-inheritance]]
 === Inheritance
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-inheritance: {core-project-dir}/src/test/java/org/hibernate/orm/test/inheritance
 :extrasdir: extras/inheritance
@@ -368,4 +367,4 @@ This is the resulting table structure:
 [source,sql]
 ----
 include::{extrasdir}/embeddable-inheritance-create-table-example.sql[]
-----
+----
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/naming.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/naming.adoc
@@ -1,6 +1,5 @@
 [[naming]]
 === Naming strategies
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-naming: {core-project-dir}/src/test/java/org/hibernate/orm/test/naming
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/natural_id.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/natural_id.adoc
@@ -1,6 +1,5 @@
 [[naturalid]]
 === Natural Ids
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-naturalid: {core-project-dir}/src/test/java/org/hibernate/orm/test/mapping/identifier
 :jcache-project-dir: {root-project-dir}/hibernate-jcache
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/partitioning.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/partitioning.adoc
@@ -1,6 +1,5 @@
 [[partitioning]]
 === Partitioning
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-partition-key: {core-project-dir}/src/test/java/org/hibernate/orm/test/mapping/identifier
 :extrasdir: extras
@@ -38,4 +37,4 @@ When updating or deleting an entity, Hibernate will include a partition key cons
 update user_tbl set firstname=?,lastname=?,tenantKey=? where id=? and tenantKey=?
 delete from user_tbl where id=? and tenantKey=?
 ----
-====
+====
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/soft_delete.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/soft_delete.adoc
@@ -1,6 +1,5 @@
 [[soft-delete]]
 === Soft Delete
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :testing-dir: {core-project-dir}/src/test/java/org/hibernate/orm/test/softdelete
 
@@ -103,8 +102,8 @@ For entity hierarchies, the soft delete applies to all inheritance types.
 ====
 [source,java]
 ----
-include::{testing-dir}/secondary/JoinedRoot.java[tag=example-soft-delete-secondary, indent=0]
-include::{testing-dir}/secondary/JoinedSub.java[tag=example-soft-delete-secondary, indent=0]
+include::{testing-dir}/discovery/secondary/JoinedRoot.java[tag=example-soft-delete-secondary, indent=0]
+include::{testing-dir}/discovery/secondary/JoinedSub.java[tag=example-soft-delete-secondary, indent=0]
 ----
 ====
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/domain/types.adoc b/documentation/src/main/asciidoc/userguide/chapters/domain/types.adoc
@@ -1,6 +1,5 @@
 [[mapping-types]]
 === Mapping types
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-mapping: {core-project-dir}/src/test/java/org/hibernate/orm/test/mapping
 :extrasdir: extras/types
diff --git a/documentation/src/main/asciidoc/userguide/chapters/envers/Envers.adoc b/documentation/src/main/asciidoc/userguide/chapters/envers/Envers.adoc
@@ -1,6 +1,5 @@
 [[envers]]
 == Envers
-:root-project-dir: ../../../../../../..
 :envers-project-dir: {root-project-dir}/hibernate-envers
 :example-dir-envers: {envers-project-dir}/src/test/java/org/hibernate/orm/test/envers
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/events/Events.adoc b/documentation/src/main/asciidoc/userguide/chapters/events/Events.adoc
@@ -1,6 +1,5 @@
 [[events]]
 == Interceptors and Events
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-event: {core-project-dir}/src/test/java/org/hibernate/orm/test/events
 :example-dir-event-resources: {core-project-dir}/src/test/resources/org/hibernate/orm/test/events
diff --git a/documentation/src/main/asciidoc/userguide/chapters/fetching/Fetching.adoc b/documentation/src/main/asciidoc/userguide/chapters/fetching/Fetching.adoc
@@ -1,6 +1,5 @@
 [[fetching]]
 == Fetching
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-fetching: {core-project-dir}/src/test/java/org/hibernate/orm/test/fetching
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/flushing/Flushing.adoc b/documentation/src/main/asciidoc/userguide/chapters/flushing/Flushing.adoc
@@ -1,6 +1,5 @@
 [[flushing]]
 == Flushing
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-flushing: {core-project-dir}/src/test/java/org/hibernate/orm/test/flush
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/locking/Locking.adoc b/documentation/src/main/asciidoc/userguide/chapters/locking/Locking.adoc
@@ -1,6 +1,5 @@
 [[locking]]
 == Locking
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-locking: {core-project-dir}/src/test/java/org/hibernate/orm/test/locking
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/multitenancy/MultiTenancy.adoc b/documentation/src/main/asciidoc/userguide/chapters/multitenancy/MultiTenancy.adoc
@@ -1,6 +1,5 @@
 [[multitenacy]]
 == Multitenancy
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-multitenancy: {core-project-dir}/src/test/java/org/hibernate/orm/test/multitenancy
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/pc/BytecodeEnhancement.adoc b/documentation/src/main/asciidoc/userguide/chapters/pc/BytecodeEnhancement.adoc
@@ -1,6 +1,5 @@
 [[BytecodeEnhancement]]
 === Bytecode Enhancement
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-enhancement: {core-project-dir}/src/test/java/org/hibernate/orm/test/pc
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/pc/PersistenceContext.adoc b/documentation/src/main/asciidoc/userguide/chapters/pc/PersistenceContext.adoc
@@ -1,6 +1,5 @@
 [[pc]]
 == Persistence Context
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-pc: {core-project-dir}/src/test/java/org/hibernate/orm/test/pc
 :jcache-project-dir: {root-project-dir}/hibernate-jcache
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/criteria/Criteria.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/criteria/Criteria.adoc
@@ -1,6 +1,5 @@
 [[criteria]]
 == Criteria
-:root-project-dir: ../../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-criteria: {core-project-dir}/src/test/java/org/hibernate/orm/test/query/criteria
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/criteria/CriteriaExtensions.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/criteria/CriteriaExtensions.adoc
@@ -1,6 +1,5 @@
 [[criteria-extensions]]
 == Criteria extensions
-:root-project-dir: ../../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-criteria: {core-project-dir}/src/test/java/org/hibernate/orm/test/query/criteria
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/extensions/Vector.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/extensions/Vector.adoc
@@ -1,6 +1,5 @@
 [[vector-module]]
 == Hibernate Vector module
-:root-project-dir: ../../../../../../../..
 :vector-project-dir: {root-project-dir}/hibernate-vector
 :example-dir-vector: {vector-project-dir}/src/test/java/org/hibernate/vector
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/hql/Query.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/hql/Query.adoc
@@ -1,6 +1,5 @@
 [[hql]]
 == Java API for HQL and JPQL
-:root-project-dir: ../../../../../../../..
 :testing-project-dir: {root-project-dir}/hibernate-testing
 :example-dir-model: {testing-project-dir}/src/main/java/org/hibernate/testing/orm/domain/userguide
 :core-project-dir: {root-project-dir}/hibernate-core
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/hql/QueryLanguage.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/hql/QueryLanguage.adoc
@@ -1,6 +1,5 @@
 [[query-language]]
 == Hibernate Query Language
-:root-project-dir: ../../../../../../../..
 :testing-project-dir: {root-project-dir}/hibernate-testing
 :example-dir-model: {testing-project-dir}/src/main/java/org/hibernate/testing/orm/domain/userguide
 :core-project-dir: {root-project-dir}/hibernate-core
@@ -2023,7 +2022,7 @@ include::{json-example-dir-hql}/JsonArrayAggregateTest.java[tags=hql-json-arraya
 
 Creates a JSON object by aggregating values.
 
-[[hql-json-arrayagg-bnf]]
+[[hql-json-objectagg-bnf]]
 [source, antlrv4, indent=0]
 ----
 include::{extrasdir}/json_objectagg_bnf.txt[]
@@ -2443,7 +2442,7 @@ WARNING: SAP HANA, MySQL, MariaDB and HSQLDB do not support this function.
 
 Aggregates XML elements by concatenation.
 
-[[hql-xmlexists-bnf]]
+[[hql-xmlagg-bnf]]
 [source, antlrv4, indent=0]
 ----
 include::{extrasdir}/xmlagg_bnf.txt[]
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/native/Native.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/native/Native.adoc
@@ -1,6 +1,5 @@
 [[sql]]
 == Native SQL Queries
-:root-project-dir: ../../../../../../../..
 :testing-project-dir: {root-project-dir}/hibernate-testing
 :example-dir-model: {testing-project-dir}/src/main/java/org/hibernate/testing/orm/domain/userguide
 :core-project-dir: {root-project-dir}/hibernate-core
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/programmatic/QuerySpecification.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/programmatic/QuerySpecification.adoc
@@ -1,6 +1,5 @@
 [[QuerySpecification]]
 == Programmatic Query Specification
-:root-project-dir: ../../../../../../../..
 
 Hibernate offers an API for creating a representation of a query, adjusting that representation programmatically, and then creating an executable form of the query.  The idea is similar in concept to <<chapters/query/criteria/Criteria.adoc#criteria,criteria queries>>, but focused on ease-of-use and less verbosity.
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/spatial/Spatial.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/spatial/Spatial.adoc
@@ -1,6 +1,5 @@
 [[spatial]]
 == Spatial
-:root-project-dir: ../../../../../../../..
 :spatial-project-dir: {root-project-dir}/hibernate-spatial
 :example-dir-spatial: {spatial-project-dir}/src/test/java/org/hibernate/spatial/testing
 :extrasdir: extras
diff --git a/documentation/src/main/asciidoc/userguide/chapters/schema/Schema.adoc b/documentation/src/main/asciidoc/userguide/chapters/schema/Schema.adoc
@@ -1,6 +1,5 @@
 [[schema-generation]]
 == Schema Generation
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-schemagen: {core-project-dir}/src/test/java/org/hibernate/orm/test/schema
 :example-dir-schemagen-resources: {core-project-dir}/src/test/resources
diff --git a/documentation/src/main/asciidoc/userguide/chapters/tooling/Tooling.adoc b/documentation/src/main/asciidoc/userguide/chapters/tooling/Tooling.adoc
@@ -1,6 +1,5 @@
 [[tooling]]
 == Build Tool Integration
-:root-project-dir: ../../../../../../..
 :testing-project-dir: {root-project-dir}/hibernate-testing
 :example-dir-model: {testing-project-dir}/src/main/java/org/hibernate/testing/orm/domain/userguide
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/tooling/modelgen.adoc b/documentation/src/main/asciidoc/userguide/chapters/tooling/modelgen.adoc
@@ -1,6 +1,5 @@
 [[tooling-modelgen]]
 === Static Metamodel Generator
-:root-project-dir: ../../../../../../..
 :testing-project-dir: {root-project-dir}/hibernate-testing
 :example-dir-model: {testing-project-dir}/src/main/java/org/hibernate/testing/orm/domain/userguide
 :example-dir-metamodelgen-generated: {testing-project-dir}/target/generated/sources/annotationProcessor/java/main/org/hibernate/testing/orm/domain/userguide
diff --git a/documentation/src/main/asciidoc/userguide/chapters/transactions/Transactions.adoc b/documentation/src/main/asciidoc/userguide/chapters/transactions/Transactions.adoc
@@ -1,6 +1,5 @@
 [[transactions]]
 == Transactions
-:root-project-dir: ../../../../../../..
 :core-project-dir: {root-project-dir}/hibernate-core
 :example-dir-transaction: {core-project-dir}/src/test/java/org/hibernate/orm/test/transactions
 
