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;
+ }
+}