From 3b99cbc172e680198918cc5bed7597dee21048ea Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Herv=C3=A9=20Boutemy?= <hboutemy@apache.org>
Date: Sun, 2 Aug 2026 10:38:07 +0100
Subject: [PATCH 1/2] fix configuration page generation

---
 pom.xml | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/pom.xml b/pom.xml
index 81854d08d4b8..62f6dc9fef7d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1078,6 +1078,16 @@ under the License.
                 <artifactId>maven-resolver-tools</artifactId>
                 <version>${resolverVersion}</version>
               </dependency>
+              <dependency>
+                <groupId>org.apache.maven</groupId>
+                <artifactId>maven-core</artifactId>
+                <version>${project.version}</version>
+              </dependency>
+              <dependency>
+                <groupId>org.apache.maven</groupId>
+                <artifactId>maven-compat</artifactId>
+                <version>${project.version}</version>
+              </dependency>
             </dependencies>
             <executions>
               <execution>

From 3e082c5e2e858d6635815ea6b4c5a3e0e0f9bbe5 Mon Sep 17 00:00:00 2001
From: Slawomir Jaranowski <s.jaranowski@gmail.com>
Date: Wed, 5 Aug 2026 22:55:21 +0200
Subject: [PATCH 2/2] my try to build the config page

---
 pom.xml | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/pom.xml b/pom.xml
index 62f6dc9fef7d..449d88f13dad 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1079,14 +1079,11 @@ under the License.
                 <version>${resolverVersion}</version>
               </dependency>
               <dependency>
+                <!-- we need a dependency on maven-api-annotations to be able to load org.apache.maven.api.annotations.Config class -->
                 <groupId>org.apache.maven</groupId>
-                <artifactId>maven-core</artifactId>
-                <version>${project.version}</version>
-              </dependency>
-              <dependency>
-                <groupId>org.apache.maven</groupId>
-                <artifactId>maven-compat</artifactId>
-                <version>${project.version}</version>
+                <artifactId>maven-api-annotations</artifactId>
+                <!-- use previous version to avoid dependency cycles -->
+                <version>4.0.0-rc-6</version>
               </dependency>
             </dependencies>
             <executions>
@@ -1110,7 +1107,8 @@ under the License.
                     hence template is renamed to maven-configuration.md.vm, to avoid conflict (and picking up resolver template)
                     -->
                     <argument>--templates=maven-configuration.md</argument>
-                    <argument>${project.basedir}</argument>
+                    <!-- only look at maven-api-core, as it only contains configuration class org.apache.maven.api.Constants  -->
+                    <argument>${project.basedir}/api/maven-api-core</argument>
                     <argument>${project.build.directory}/generated-site/markdown</argument>
                   </arguments>
                 </configuration>
@@ -1134,7 +1132,7 @@ under the License.
                     to avoid double execution
                     -->
                     <argument>--templates=configuration.properties,configuration.yaml</argument>
-                    <argument>${project.basedir}</argument>
+                    <argument>${project.basedir}/api/maven-api-core</argument>
                     <argument>${project.build.directory}/generated-site/resources</argument>
                   </arguments>
                 </configuration>