This is an automated email from the ASF dual-hosted git repository.

elharo pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git


The following commit(s) were added to refs/heads/master by this push:
     new aec5cd78 Add CI check for Markdown syntax issues (#1737)
aec5cd78 is described below

commit aec5cd782f1a76c99124ff1f14953eb32c2cb2c0
Author: Elliotte Rusty Harold <[email protected]>
AuthorDate: Wed Nov 4 14:02:31 2026 +0000

    Add CI check for Markdown syntax issues (#1737)
    
    * Validate escaped issue links in release notes
    
    * Expand markdown link test to all docs
    
    * Update JUnit Jupiter version to 5.11.3
    
    Co-authored-by: Copilot Autofix powered by AI 
<[email protected]>
    
    * Address review comments
    
    * Validate Markdown links with a parser
    
    * Clarify Markdown link validation
    
    * Shorten Markdown link assertion message
    
    * Update test failure message to be more general
    
    * markdownDocsAreWellFormed
    
    * spotless
    
    ---------
    
    Co-authored-by: Copilot Autofix powered by AI 
<[email protected]>
---
 content/markdown/docs/4.0.0-rc-4/release-notes.md  |  4 +-
 content/markdown/docs/4.0.0-rc-5/release-notes.md  |  2 +-
 content/markdown/docs/4.0.0-rc-6/release-notes.md  | 10 +--
 content/markdown/docs/4.0.0-rc-7/release-notes.md  | 36 ++++----
 pom.xml                                            | 17 ++++
 .../org/apache/maven/site/MarkdownDocsTest.java    | 99 ++++++++++++++++++++++
 6 files changed, 142 insertions(+), 26 deletions(-)

diff --git a/content/markdown/docs/4.0.0-rc-4/release-notes.md 
b/content/markdown/docs/4.0.0-rc-4/release-notes.md
index 791e1ada..40572eca 100644
--- a/content/markdown/docs/4.0.0-rc-4/release-notes.md
+++ b/content/markdown/docs/4.0.0-rc-4/release-notes.md
@@ -134,7 +134,7 @@ Worth mentioning is the new upgrade tool which can be used 
to fix your `pom.xml`
 - [[MNG-8670](https://issues.apache.org/jira/browse/MNG-8670)] - Fix 
concurrent builder missing/wrong project events 
([#2251](https://github.com/apache/maven/pull/2251)) @oehme
 - [[MNG-8674](https://issues.apache.org/jira/browse/MNG-8674)] - Deprecate 
mergeId in the Maven 3 model and remove it in the new model 
([#2233](https://github.com/apache/maven/pull/2233)) @gnodet
 - [[MNG-8694](https://issues.apache.org/jira/browse/MNG-8694)] - Fix version 
interpolation and ternary operator 
([#2272](https://github.com/apache/maven/pull/2272)) @kamilkrzywanski
-- [[MNGSITE-393]](https://issues.apache.org/jira/browse/MNGSITE-393) - Remove 
Maven 1 and 2 references ([#2276](https://github.com/apache/maven/pull/2276)) 
@elharo
+- [\[MNGSITE-393\]](https://issues.apache.org/jira/browse/MNGSITE-393) - 
Remove Maven 1 and 2 references 
([#2276](https://github.com/apache/maven/pull/2276)) @elharo
 - Remove unneeded toString and valueOf calls 
([#2230](https://github.com/apache/maven/pull/2230)) @elharo
 - Drop unused assembly exclude 
([#2266](https://github.com/apache/maven/pull/2266)) @cstamas
 - aether repository system isn't used 
([#2237](https://github.com/apache/maven/pull/2237)) @elharo
@@ -152,7 +152,7 @@ Worth mentioning is the new upgrade tool which can be used 
to fix your `pom.xml`
 - Grammar and typo fixes in javadoc and other comments 
([#2222](https://github.com/apache/maven/pull/2222)) @elharo
 - Remove methods that duplicate superclass methods 
([#2211](https://github.com/apache/maven/pull/2211)) @elharo
 - [[MNG-8637](https://issues.apache.org/jira/browse/MNG-8637)] - Pull out 
Standalone API from UTs ([#2226](https://github.com/apache/maven/pull/2226)) 
@gnodet
-- [[MRESOLVER-673]](https://issues.apache.org/jira/browse/MRESOLVER-673) - 
Improve model validator error messages 
([#2227](https://github.com/apache/maven/pull/2227)) @cstamas
+- [\[MRESOLVER-673\]](https://issues.apache.org/jira/browse/MRESOLVER-673) - 
Improve model validator error messages 
([#2227](https://github.com/apache/maven/pull/2227)) @cstamas
 - [[MNG-8660](https://issues.apache.org/jira/browse/MNG-8660)] - Decouple 
legacy prompter from implementation details 
([#2196](https://github.com/apache/maven/pull/2196)) @oehme
 - Add missing Javadoc to API subprojects 
([#2218](https://github.com/apache/maven/pull/2218)) @gnodet
 - prefer primitive type ([#2216](https://github.com/apache/maven/pull/2216)) 
@elharo
diff --git a/content/markdown/docs/4.0.0-rc-5/release-notes.md 
b/content/markdown/docs/4.0.0-rc-5/release-notes.md
index 6ba0581a..99429282 100644
--- a/content/markdown/docs/4.0.0-rc-5/release-notes.md
+++ b/content/markdown/docs/4.0.0-rc-5/release-notes.md
@@ -202,7 +202,7 @@ Worth mentioning is the new upgrade tool which can be used 
to fix your `pom.xml`
 - Maven 4.0.x backport mimir 
([#11180](https://github.com/apache/maven/pull/11180)) @cstamas
 - commons-cli deprecations (#11170) 
([#11176](https://github.com/apache/maven/pull/11176)) @cstamas
 - Mimir updates (#11161) 
([#11166](https://github.com/apache/maven/pull/11166)) @cstamas
-- [[[MNG-8696]](https://issues.apache.org/jira/browse/MNG-8696) - 
](https://issues.apache.org/jira/browse/MNG-8696) - Hide the cache from 
DefaultDependencyResolverResult constructor 
([#11154](https://github.com/apache/maven/pull/11154)) @desruisseaux
+- [\[MNG-8696\]](https://issues.apache.org/jira/browse/MNG-8696) - Hide the 
cache from DefaultDependencyResolverResult constructor 
([#11154](https://github.com/apache/maven/pull/11154)) @desruisseaux
 - Generating configuration documentation during site build 
([#10979](https://github.com/apache/maven/pull/10979)) @slawekjaranowski
 - Improvements in ITs executing - provide default local repo 
([#10963](https://github.com/apache/maven/pull/10963)) @slawekjaranowski
 - Backport: Fix build and Jenkinsfile  (#10904) 
([#10905](https://github.com/apache/maven/pull/10905)) @cstamas
diff --git a/content/markdown/docs/4.0.0-rc-6/release-notes.md 
b/content/markdown/docs/4.0.0-rc-6/release-notes.md
index 7e319b21..9b933ad3 100644
--- a/content/markdown/docs/4.0.0-rc-6/release-notes.md
+++ b/content/markdown/docs/4.0.0-rc-6/release-notes.md
@@ -82,11 +82,11 @@ Maven 4.0.0-rc-6 continues gathering feedback before 
releasing Maven 4.0.0 GA. T
 - Backport the use of hardlink instead of file copy 
([#11564](https://github.com/apache/maven/pull/11564)) @desruisseaux
 - Accept Java module names as attached artifactId even if they differ from the 
project's artifactId ([#11573](https://github.com/apache/maven/pull/11573)) 
@desruisseaux
 - Add module-aware resource handling for modular sources 
([#11700](https://github.com/apache/maven/pull/11700)) @desruisseaux
-- [[MNG-8507]](https://issues.apache.org/jira/browse/MNG-8507) - Reduce 
allocation pressure in model building pipeline 
([#12540](https://github.com/apache/maven/pull/12540)) @gnodet
+- [\[MNG-8507\]](https://issues.apache.org/jira/browse/MNG-8507) - Reduce 
allocation pressure in model building pipeline 
([#12540](https://github.com/apache/maven/pull/12540)) @gnodet
 - Fix #12530: add mvnup upgrade strategies for Maven 4 known compatibility 
issues ([#12560](https://github.com/apache/maven/pull/12560)) @gnodet
 - Introduce validation control 
([#12548](https://github.com/apache/maven/pull/12548)) @cstamas
 - Backport #12505: mvnup: widen exact Maven version pins to allow Maven 4 
([#12508](https://github.com/apache/maven/pull/12508)) @gnodet
-- [[MNG-5913]](https://issues.apache.org/jira/browse/MNG-5913) - Allow 
defining aliases for existing server configurations in settings.xml 
([#12473](https://github.com/apache/maven/pull/12473)) @slawekjaranowski
+- [\[MNG-5913\]](https://issues.apache.org/jira/browse/MNG-5913) - Allow 
defining aliases for existing server configurations in settings.xml 
([#12473](https://github.com/apache/maven/pull/12473)) @slawekjaranowski
 - Backport #12454: mvnup upgrade strategies and compatibility improvements 
([#12467](https://github.com/apache/maven/pull/12467)) @gnodet
 - In failed build limit reactor summary to only failed modules 
([#12469](https://github.com/apache/maven/pull/12469)) @slawekjaranowski
 - Add mvnup SourceStrategy for migrating to `<source>` elements 
([#12357](https://github.com/apache/maven/pull/12357)) @gnodet
@@ -104,7 +104,7 @@ Maven 4.0.0-rc-6 continues gathering feedback before 
releasing Maven 4.0.0 GA. T
 - Remove an optimization on PathSelector producing false negatives 
([#12623](https://github.com/apache/maven/pull/12623)) @desruisseaux
 - Remove erroneous path normalization optimization + regression test 
([#12621](https://github.com/apache/maven/pull/12621)) @gnodet
 - Fix #12583: Inverted file existence check in DefaultTransport.put() 
([#12619](https://github.com/apache/maven/pull/12619)) @gnodet @elharo
-- [[MNG-8507]](https://issues.apache.org/jira/browse/MNG-8507) mvnup: skip 
dedup inside plugin `<configuration>` elements 
([#12582](https://github.com/apache/maven/pull/12582)) @gnodet
+- [\[MNG-8507\]](https://issues.apache.org/jira/browse/MNG-8507) mvnup: skip 
dedup inside plugin `<configuration>` elements 
([#12582](https://github.com/apache/maven/pull/12582)) @gnodet
 - Fix BOM consumer POM leaving property references unresolved 
([#12627](https://github.com/apache/maven/pull/12627)) @gnodet
 - [MNG-8425] Fix mvnenc init saving invalid master source configuration 
([#12564](https://github.com/apache/maven/pull/12564)) @gnodet
 - Consumer POM of multi-module project should exclude `<build>` and 
`<dependencies>` elements 
([#11764](https://github.com/apache/maven/pull/11764)) @desruisseaux
@@ -113,7 +113,7 @@ Maven 4.0.0-rc-6 continues gathering feedback before 
releasing Maven 4.0.0 GA. T
 - Fix #12531: filter NO_REPOSITORY sentinel from mapped exceptions in 
ArtifactResolverResult ([#12561](https://github.com/apache/maven/pull/12561)) 
@gnodet
 - Fix #12534: Wire up @After annotation processing in Maven core 
([#12566](https://github.com/apache/maven/pull/12566)) @gnodet
 - Fix #12427: Reject path-traversal segments in coordinate ids and versions 
([#12565](https://github.com/apache/maven/pull/12565)) @gnodet
-- [[MNG-11147]](https://issues.apache.org/jira/browse/MNG-11147) - Fix BOM 
version inference for sibling modules in dependencyManagement 
([#12569](https://github.com/apache/maven/pull/12569)) @gnodet
+- [\[MNG-11147\]](https://issues.apache.org/jira/browse/MNG-11147) - Fix BOM 
version inference for sibling modules in dependencyManagement 
([#12569](https://github.com/apache/maven/pull/12569)) @gnodet
 - Preserve unresolved ${...} in CLI -D values 
([#12524](https://github.com/apache/maven/pull/12524)) @ascheman
 - Avoid IllegalStateException on duplicate profile ids in DefaultModelBuilder 
([#12506](https://github.com/apache/maven/pull/12506)) @ascheman
 - Fix deadlock in AbstractRequestCache 
([#12468](https://github.com/apache/maven/pull/12468)) @gnodet
@@ -123,7 +123,7 @@ Maven 4.0.0-rc-6 continues gathering feedback before 
releasing Maven 4.0.0 GA. T
 - Fix CI-friendly ${revision} not interpolated for non-build POM reads 
([#12322](https://github.com/apache/maven/pull/12322)) @gnodet
 - Fix mvn.cmd jvm.config read failing silently on Windows CI 
([#12379](https://github.com/apache/maven/pull/12379)) @gnodet
 - Fix mvnup spurious pluginManagement injection for remote parent plugins 
([#12351](https://github.com/apache/maven/pull/12351)) @gnodet
-- [[MNG-8650]](https://issues.apache.org/jira/browse/MNG-8650) - Fix 
MAVEN_ARGS backslash stripping on Windows 
([#12349](https://github.com/apache/maven/pull/12349)) @gnodet
+- [\[MNG-8650\]](https://issues.apache.org/jira/browse/MNG-8650) - Fix 
MAVEN_ARGS backslash stripping on Windows 
([#12349](https://github.com/apache/maven/pull/12349)) @gnodet
 - Do not force metadata download for plugin prefix resolution 
([#12343](https://github.com/apache/maven/pull/12343)) @gnodet
 - Fix NPE in DefaultLookup.lookupOptional() when container returns null 
([#12340](https://github.com/apache/maven/pull/12340)) @gnodet
 - Use stack-passed Set for activeModelReads cycle detection 
([#12325](https://github.com/apache/maven/pull/12325)) @gnodet
diff --git a/content/markdown/docs/4.0.0-rc-7/release-notes.md 
b/content/markdown/docs/4.0.0-rc-7/release-notes.md
index 079f1830..d6223940 100644
--- a/content/markdown/docs/4.0.0-rc-7/release-notes.md
+++ b/content/markdown/docs/4.0.0-rc-7/release-notes.md
@@ -95,37 +95,37 @@ Maven 4.0.0-rc-7 continues gathering feedback before 
releasing Maven 4.0.0 GA. T
 - Fix #13084: sandbox profile activation context for external model builds 
([#13158](https://github.com/apache/maven/pull/13158)) @gnodet
 - Fix: implement Node.getRepository() via local repository manager lookup 
([#13159](https://github.com/apache/maven/pull/13159)) @gnodet
 - Fix #13100: honor repositories from legitimately-active external model 
profiles ([#13155](https://github.com/apache/maven/pull/13155)) @gnodet
-- [MNG-5146](https://issues.apache.org/jira/browse/MNG-5146) - Fix parent 
relativePath mismatch check 
([#13157](https://github.com/apache/maven/pull/13157)) @gnodet
+- [\[MNG-5146\]](https://issues.apache.org/jira/browse/MNG-5146) - Fix parent 
relativePath mismatch check 
([#13157](https://github.com/apache/maven/pull/13157)) @gnodet
 - Lower-case the OS family before matching it against the family names 
([#13154](https://github.com/apache/maven/pull/13154)) @gnodet
 - Normalize lazy StAX parse failures in MavenXpp3Reader 
([#13149](https://github.com/apache/maven/pull/13149)) @gnodet
 - Evaluate profile activation conditions lazily 
([#13144](https://github.com/apache/maven/pull/13144)) @gnodet
-- [MNG-6979](https://issues.apache.org/jira/browse/MNG-6979) - Initialize the 
current project from the execution root 
([#13143](https://github.com/apache/maven/pull/13143)) @gnodet
+- [\[MNG-6979\]](https://issues.apache.org/jira/browse/MNG-6979) - Initialize 
the current project from the execution root 
([#13143](https://github.com/apache/maven/pull/13143)) @gnodet
 - Fix NPE on a recursive property reference in a list field 
([#13145](https://github.com/apache/maven/pull/13145)) @gnodet
-- [MNG-6568](https://issues.apache.org/jira/browse/MNG-6568) - Fix comparison 
cycles in version qualifiers 
([#13113](https://github.com/apache/maven/pull/13113)) @gnodet
-- [MNG-8678](https://issues.apache.org/jira/browse/MNG-8678) - Concurrent 
executor ignores java.lang.Error subclasses 
([#13067](https://github.com/apache/maven/pull/13067)) @gnodet
+- [\[MNG-6568\]](https://issues.apache.org/jira/browse/MNG-6568) - Fix 
comparison cycles in version qualifiers 
([#13113](https://github.com/apache/maven/pull/13113)) @gnodet
+- [\[MNG-8678\]](https://issues.apache.org/jira/browse/MNG-8678) - Concurrent 
executor ignores java.lang.Error subclasses 
([#13067](https://github.com/apache/maven/pull/13067)) @gnodet
 - Fix #13068: make PluginDependenciesResolver methods default 
([#13069](https://github.com/apache/maven/pull/13069)) @ascheman
 - Fix filterByScope to expand lifecycle scopes for build ordering 
([#13070](https://github.com/apache/maven/pull/13070)) @gnodet
 - Fix getDispatchedPaths() leaking mutable nested lists 
([#13057](https://github.com/apache/maven/pull/13057)) @gnodet
-- [MNG-8174](https://issues.apache.org/jira/browse/MNG-8174) - Fix NPE when a 
property references itself in a plugin configuration 
([#12935](https://github.com/apache/maven/pull/12935)) @elharo
+- [\[MNG-8174\]](https://issues.apache.org/jira/browse/MNG-8174) - Fix NPE 
when a property references itself in a plugin configuration 
([#12935](https://github.com/apache/maven/pull/12935)) @elharo
 - Fix #12985: Upgrade toolchains-plugin when adding select-jdk-toolchain 
execution ([#13026](https://github.com/apache/maven/pull/13026)) @gnodet
 - Fix ToolchainPluginStrategy to detect inherited source levels from parent 
POMs ([#13025](https://github.com/apache/maven/pull/13025)) @gnodet
 - Fix consumer POM leaving extension-contributed user properties 
uninterpolated ([#13023](https://github.com/apache/maven/pull/13023)) @gnodet
 - Fix #12986: Throw descriptive UnsupportedOperationException instead of NPE 
in MavenSession.lookup() ([#13020](https://github.com/apache/maven/pull/13020)) 
@gnodet
 - Fix #12989: mvnup plugin upgrades should respect project JDK version 
([#13024](https://github.com/apache/maven/pull/13024)) @gnodet
-- [MNG-8633](https://issues.apache.org/jira/browse/MNG-8633) - mvnup: inject 
standalone Nashorn for antrun JavaScript compatibility 
([#13022](https://github.com/apache/maven/pull/13022)) @gnodet
+- [\[MNG-8633\]](https://issues.apache.org/jira/browse/MNG-8633) - mvnup: 
inject standalone Nashorn for antrun JavaScript compatibility 
([#13022](https://github.com/apache/maven/pull/13022)) @gnodet
 - mvnup: upgrade BND plugins to fix ConcurrentModificationException on JDK 
17.0.13+ ([#13021](https://github.com/apache/maven/pull/13021)) @gnodet
-- [MNG-8765](https://issues.apache.org/jira/browse/MNG-8765) - Pre-interpolate 
plugin configuration before type conversion 
([#13019](https://github.com/apache/maven/pull/13019)) @gnodet
+- [\[MNG-8765\]](https://issues.apache.org/jira/browse/MNG-8765) - 
Pre-interpolate plugin configuration before type conversion 
([#13019](https://github.com/apache/maven/pull/13019)) @gnodet
 - Fix #13004: enable deterministic profile activation for BUILD_CONSUMER 
([#13015](https://github.com/apache/maven/pull/13015)) @gnodet
-- [MNG-8765](https://issues.apache.org/jira/browse/MNG-8765) - Pre-interpolate 
plugin configuration before type conversion 
([#13017](https://github.com/apache/maven/pull/13017)) @gnodet
+- [\[MNG-8765\]](https://issues.apache.org/jira/browse/MNG-8765) - 
Pre-interpolate plugin configuration before type conversion 
([#13017](https://github.com/apache/maven/pull/13017)) @gnodet
 - Fix #12991: skip shade-plugin upgrade when custom ResourceTransformers are 
present ([#13016](https://github.com/apache/maven/pull/13016)) @gnodet
-- [MNG-12984](https://issues.apache.org/jira/browse/MNG-12984) - Fix invalid 
Automatic-Module-Name entries in mvnup plugin upgrades 
([#13013](https://github.com/apache/maven/pull/13013)) @gnodet
+- [\[MNG-12984\]](https://issues.apache.org/jira/browse/MNG-12984) - Fix 
invalid Automatic-Module-Name entries in mvnup plugin upgrades 
([#13013](https://github.com/apache/maven/pull/13013)) @gnodet
 - Fix compatibility spelling in CLI help text 
([#13012](https://github.com/apache/maven/pull/13012)) @gnodet
-- [MNG-8708](https://issues.apache.org/jira/browse/MNG-8708) - Fix parent 
inference ([#13010](https://github.com/apache/maven/pull/13010)) @gnodet
+- [\[MNG-8708\]](https://issues.apache.org/jira/browse/MNG-8708) - Fix parent 
inference ([#13010](https://github.com/apache/maven/pull/13010)) @gnodet
 - Scope server credentials and validate legacy relocation coordinates 
([#12977](https://github.com/apache/maven/pull/12977)) @gnodet
 - Fix version comparison and parsing inconsistencies in maven-artifact 
([#12942](https://github.com/apache/maven/pull/12942)) @slachiewicz
 - Validate metadata inputs across legacy and new API paths, clone proxies 
before decryption ([#12945](https://github.com/apache/maven/pull/12945)) 
@slachiewicz
-- [MNG-8450](https://issues.apache.org/jira/browse/MNG-8450) - Report BOM 
import warnings only at declaration sites 
([#13003](https://github.com/apache/maven/pull/13003)) @gnodet
-- [MNG-8287](https://issues.apache.org/jira/browse/MNG-8287) - Fix consumer 
POM packaging profile resolution 
([#12967](https://github.com/apache/maven/pull/12967)) @gnodet
+- [\[MNG-8450\]](https://issues.apache.org/jira/browse/MNG-8450) - Report BOM 
import warnings only at declaration sites 
([#13003](https://github.com/apache/maven/pull/13003)) @gnodet
+- [\[MNG-8287\]](https://issues.apache.org/jira/browse/MNG-8287) - Fix 
consumer POM packaging profile resolution 
([#12967](https://github.com/apache/maven/pull/12967)) @gnodet
 - Fix #12931: do not rewrite unmodified POMs in mvnup apply 
([#12972](https://github.com/apache/maven/pull/12972)) @gnodet
 - Fix modello velocity phase for concurrent builder compatibility 
([#12963](https://github.com/apache/maven/pull/12963)) @gnodet
 - Fix #12912: assign FastTerminal before starting the build thread 
([#12961](https://github.com/apache/maven/pull/12961)) @gnodet
@@ -135,7 +135,7 @@ Maven 4.0.0-rc-7 continues gathering feedback before 
releasing Maven 4.0.0 GA. T
 - Fix operator precedence skipping type=bom dependency imports 
([#12930](https://github.com/apache/maven/pull/12930)) @gnodet
 - Fix: make ProjectIndex thread-safe for parallel builds 
([#12926](https://github.com/apache/maven/pull/12926)) @gnodet
 - Fix #12602: Preserve Properties defaults in immutable copies 
([#12910](https://github.com/apache/maven/pull/12910)) @goutamadwant
-- [MNG-8693](https://issues.apache.org/jira/browse/MNG-8693) - Avoid resolving 
unused plugins for direct goals 
([#12920](https://github.com/apache/maven/pull/12920)) @gnodet
+- [\[MNG-8693\]](https://issues.apache.org/jira/browse/MNG-8693) - Avoid 
resolving unused plugins for direct goals 
([#12920](https://github.com/apache/maven/pull/12920)) @gnodet
 - Fix: interpolate properties in module/subproject path before filesystem 
resolution ([#12924](https://github.com/apache/maven/pull/12924)) @gnodet
 - Fix #12600: handle missing project index in forked executions 
([#12917](https://github.com/apache/maven/pull/12917)) @gnodet
 - Re-include macOS JLine native libraries in distribution 
([#12888](https://github.com/apache/maven/pull/12888)) @gnodet
@@ -156,14 +156,14 @@ Maven 4.0.0-rc-7 continues gathering feedback before 
releasing Maven 4.0.0 GA. T
 - Fix: synchronize ReflectionValueExtractor class-introspection caches 
([#12862](https://github.com/apache/maven/pull/12862)) @gnodet
 - Fix duplicate model problem reporting, fixes #12691 
([#12807](https://github.com/apache/maven/pull/12807)) @gnodet
 - Fix ArtifactCoordinates.getId() double colon when classifier is empty 
([#12855](https://github.com/apache/maven/pull/12855)) @gnodet
-- [MNG-8129](https://issues.apache.org/jira/browse/MNG-8129) - Handle 
InvalidPathException for broken relativePath on Windows 
([#12849](https://github.com/apache/maven/pull/12849)) @gnodet
+- [\[MNG-8129\]](https://issues.apache.org/jira/browse/MNG-8129) - Handle 
InvalidPathException for broken relativePath on Windows 
([#12849](https://github.com/apache/maven/pull/12849)) @gnodet
 - Fix #12761: do not wait for the terminal on the thread building it 
([#12854](https://github.com/apache/maven/pull/12854)) @gnodet
 - Make run-its profile extract the built distribution 
([#12852](https://github.com/apache/maven/pull/12852)) @gnodet
-- [MDEP-590](https://issues.apache.org/jira/browse/MDEP-590) - Resolve 
classified POM artifacts from the reactor 
([#12831](https://github.com/apache/maven/pull/12831)) @wilx
-- [MNG-8709](https://issues.apache.org/jira/browse/MNG-8709) - Use active 
profile properties for consumer POM validation 
([#12684](https://github.com/apache/maven/pull/12684)) @goutamadwant
+- [\[MDEP-590\]](https://issues.apache.org/jira/browse/MDEP-590) - Resolve 
classified POM artifacts from the reactor 
([#12831](https://github.com/apache/maven/pull/12831)) @wilx
+- [\[MNG-8709\]](https://issues.apache.org/jira/browse/MNG-8709) - Use active 
profile properties for consumer POM validation 
([#12684](https://github.com/apache/maven/pull/12684)) @goutamadwant
 - Fix #12730: quiet mode implies raw streams to avoid stdout decoration 
([#12830](https://github.com/apache/maven/pull/12830)) @gnodet
 - Fix #12640: BOM consumer POM must not include inherited dependency 
management ([#12802](https://github.com/apache/maven/pull/12802)) @gnodet
-- [MNG-8129](https://issues.apache.org/jira/browse/MNG-8129) - Handle 
InvalidPathException for broken relativePath on Windows 
([#12741](https://github.com/apache/maven/pull/12741)) @gnodet
+- [\[MNG-8129\]](https://issues.apache.org/jira/browse/MNG-8129) - Handle 
InvalidPathException for broken relativePath on Windows 
([#12741](https://github.com/apache/maven/pull/12741)) @gnodet
 - Make profile activation conditions locale-independent 
([#12798](https://github.com/apache/maven/pull/12798)) @gnodet
 - Fix parent profile cache matching across activation contexts 
([#12801](https://github.com/apache/maven/pull/12801)) @gnodet
 - fix(api-core): properly implement Clock.withZone() in MonotonicClock 
([#12797](https://github.com/apache/maven/pull/12797)) @gnodet
@@ -194,7 +194,7 @@ Maven 4.0.0-rc-7 continues gathering feedback before 
releasing Maven 4.0.0 GA. T
 - Validate coordinates and repository precedence during artifact resolution 
([#12944](https://github.com/apache/maven/pull/12944)) @slachiewicz
 - Fix flaky FastTerminalReentrancyTest by avoiding PTY creation 
([#12971](https://github.com/apache/maven/pull/12971)) @gnodet
 - Replace deprecated Terminal.getWidth/getHeight with getColumns/getRows 
([#12969](https://github.com/apache/maven/pull/12969)) @gnodet
-- [MNG-8129](https://issues.apache.org/jira/browse/MNG-8129) - Clarify 
relativePath validation comment 
([#12965](https://github.com/apache/maven/pull/12965)) @gnodet
+- [\[MNG-8129\]](https://issues.apache.org/jira/browse/MNG-8129) - Clarify 
relativePath validation comment 
([#12965](https://github.com/apache/maven/pull/12965)) @gnodet
 - Add integration test for #12660: BOM version from imported BOM 
([#12940](https://github.com/apache/maven/pull/12940)) @gnodet
 - Use try-with-resources for AuthenticationContext 
([#12844](https://github.com/apache/maven/pull/12844)) @slachiewicz
 - Fix deprecated Maven testing API compatibility 
([#12683](https://github.com/apache/maven/pull/12683)) @goutamadwant
diff --git a/pom.xml b/pom.xml
index 60e1b574..72d1c10c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -82,6 +82,23 @@
       <artifactId>jsoup</artifactId>
       <version>1.23.2</version>
     </dependency>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.vladsch.flexmark</groupId>
+      <artifactId>flexmark</artifactId>
+      <version>0.62.2</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.vladsch.flexmark</groupId>
+      <artifactId>flexmark-ext-wikilink</artifactId>
+      <version>0.62.2</version>
+      <scope>test</scope>
+    </dependency>
   </dependencies>
 
   <repositories>
diff --git a/src/test/java/org/apache/maven/site/MarkdownDocsTest.java 
b/src/test/java/org/apache/maven/site/MarkdownDocsTest.java
new file mode 100644
index 00000000..fc5d1afb
--- /dev/null
+++ b/src/test/java/org/apache/maven/site/MarkdownDocsTest.java
@@ -0,0 +1,99 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.maven.site;
+
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import java.util.stream.Stream;
+
+import com.vladsch.flexmark.ext.wikilink.WikiLink;
+import com.vladsch.flexmark.ext.wikilink.WikiLinkExtension;
+import com.vladsch.flexmark.parser.Parser;
+import com.vladsch.flexmark.util.ast.Node;
+import com.vladsch.flexmark.util.ast.NodeVisitor;
+import com.vladsch.flexmark.util.ast.VisitHandler;
+import com.vladsch.flexmark.util.data.MutableDataSet;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+class MarkdownDocsTest {
+    private static final Pattern PARENTHESIZED_DESTINATION = 
Pattern.compile("^\\([^)\\s]+\\)");
+
+    private static final Parser MARKDOWN_PARSER = Parser.builder(
+                    new MutableDataSet().set(Parser.EXTENSIONS, 
List.of(WikiLinkExtension.create())))
+            .build();
+
+    @Test
+    void markdownDocsAreWellFormed() throws IOException {
+        Path contentDirectory = Paths.get("content/markdown");
+        List<String> violations = new ArrayList<>();
+
+        try (Stream<Path> files = Files.walk(contentDirectory)) {
+            List<Path> markdownFiles =
+                    
files.filter(MarkdownDocsTest::isMarkdownSource).sorted().toList();
+            for (Path file : markdownFiles) {
+                collectViolations(contentDirectory, file, violations);
+            }
+        }
+
+        assertTrue(violations.isEmpty(), () -> "Markdown syntax errors:\n" + 
String.join("\n", violations));
+    }
+
+    private static boolean isMarkdownSource(Path path) {
+        String name = path.getFileName().toString();
+        return name.endsWith(".md") || name.endsWith(".md.vm");
+    }
+
+    private static void collectViolations(Path contentDirectory, Path file, 
List<String> violations)
+            throws IOException {
+        String markdown = Files.readString(file, StandardCharsets.UTF_8);
+        Node document = MARKDOWN_PARSER.parse(markdown);
+
+        new NodeVisitor(new VisitHandler<>(WikiLink.class, link -> {
+                    int end = link.getEndOffset();
+                    Matcher destination = 
PARENTHESIZED_DESTINATION.matcher(markdown.substring(end));
+                    if (destination.find()) {
+                        violations.add(String.format(
+                                "  %s:%d: %s",
+                                contentDirectory.relativize(file),
+                                lineNumber(markdown, link.getStartOffset()),
+                                markdown.substring(link.getStartOffset(), end 
+ destination.end())));
+                    }
+                }))
+                .visit(document);
+    }
+
+    private static int lineNumber(String text, int offset) {
+        int line = 1;
+        for (int i = 0; i < offset; i++) {
+            if (text.charAt(i) == '\n') {
+                line++;
+            }
+        }
+        return line;
+    }
+}

Reply via email to