From 4d9708b9a0fbaf48681dcb4c82448dae5dd98272 Mon Sep 17 00:00:00 2001
From: Nassim Boutekedjiret <nassim@sentrysoftware.com>
Date: Thu, 8 Oct 2026 17:24:04 +0200
Subject: [PATCH] Issue #62 - Build the site with Doxia 2

oss-parent configures maven-site-plugin 3.12.1 with maven-skin-tools
1.3.00, which puts Velocity 1.7 / velocity-tools 2.0 and Velocity 2.3 /
velocity-tools 3.1 on the plugin class path. Maven 3.10 orders that class
path differently from Maven 3.9 and mixes them, so the site fails with
an AbstractMethodError on org.apache.velocity.tools.ToolContext.

Use maven-site-plugin 4.0.0-M16 with maven-skin-tools 1.8.01 (Doxia 2,
one Velocity generation), and the SITE 2.0.0 descriptor with
sentry-maven-skin 8.0.00, as community-connectors does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 pom.xml           | 14 ++++++++++++++
 src/site/site.xml | 19 +++++++++++--------
 2 files changed, 25 insertions(+), 8 deletions(-)

diff --git a/pom.xml b/pom.xml
index 9b9705f..04fba8f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -133,6 +133,20 @@
 		<!-- Actual build plugins -->
 		<plugins>
 
+			<!-- Site with Doxia 2: maven-site-plugin 3.12.1 (from oss-parent) mixes two Velocity generations, which -->
+			<!-- fails with Maven 3.10 (AbstractMethodError on org.apache.velocity.tools.ToolContext) -->
+			<plugin>
+				<artifactId>maven-site-plugin</artifactId>
+				<version>4.0.0-M16</version>
+				<dependencies>
+					<dependency>
+						<groupId>org.sentrysoftware.maven</groupId>
+						<artifactId>maven-skin-tools</artifactId>
+						<version>1.8.01</version>
+					</dependency>
+				</dependencies>
+			</plugin>
+
 			<!-- compiler -->
 			<plugin>
 				<artifactId>maven-compiler-plugin</artifactId>
diff --git a/src/site/site.xml b/src/site/site.xml
index a791f2c..c868fac 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -1,10 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project name="${project.name}">
+<site
+	xmlns="http://maven.apache.org/SITE/2.0.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/SITE/2.0.0 https://maven.apache.org/xsd/site-2.0.0.xsd"
+	name="${project.name}">
 
 	<skin>
 		<groupId>org.sentrysoftware.maven</groupId>
 		<artifactId>sentry-maven-skin</artifactId>
-		<version>6.4.01</version>
+		<version>8.0.00</version>
 	</skin>
 
 	<custom>
@@ -12,16 +16,15 @@
 		<keywords>http</keywords>
 	</custom>
 
-	<bannerLeft>
-		<src>images/metricshub-logo-only.png</src>
-		<href>https://metricshub.org</href>
+	<bannerLeft name="MetricsHub" href="https://metricshub.org">
+		<image src="images/metricshub-logo-only.png" />
 	</bannerLeft>
 
 	<body>
-	
+
 		<links>
 			<item name="Fork on GitHub" href="${project.scm.url}" />
-			<item name="MetricsHub&reg;" href="https://metricshub.com" />
+			<item name="MetricsHub&#174;" href="https://metricshub.com" />
 		</links>
 
 		<menu name="User Documentation">
@@ -32,4 +35,4 @@
 		<menu ref="reports" />
 	</body>
 
-</project>
\ No newline at end of file
+</site>