Skip to content

Fix dead links in site documentation - #111

Merged
slachiewicz merged 1 commit into
sitefrom
docs-fix-dead-links
Nov 19, 2026
Merged

slachiewicz merged 1 commit into
sitefrom
docs-fix-dead-links

Conversation

@slachiewicz

Copy link
Copy Markdown
Member

Several links in the site documentation point at services that no longer resolve: the Codehaus license pages, the SKS keyserver pool, and the retired OSSRH snapshots URL (404). This updates them to live equivalents so readers can follow the instructions.

Area: docs

Changes:

  • development/guidelines.md: replace the dead Codehaus license links with a statement pointing to each plugin's LICENSE.txt and https://www.apache.org/licenses/; point the site-template example's logo, banners and links at verified https://www.mojohaus.org/ URLs.
  • development/performing-a-release.md: replace the dead SKS keyserver with https://keys.openpgp.org/.
  • development/guide-testing-development-plugins.md (4 URLs) and index.md (1 URL): replace OSSRH snapshots URLs with https://central.sonatype.com/repository/maven-snapshots/.
  • Re-run Spotless's Markdown formatter on all 13 site documents (the pristine branch was already not format-clean).

Verification:

  • JAVA_HOME=...zulu-21 mvn -B -o spotless:apply — PASS (8 Markdown files normalized, POM already sorted).
  • JAVA_HOME=...zulu-21 mvn -B -o -Dspotless.action=check spotless:check — PASS.
  • JAVA_HOME=...zulu-21 mvn -B -o clean site — PASS (87 Doxia documents: 12 markdown, 75 xdoc; 7 reports).
  • Re-curled all 7 replacement URLs — all 200; the 7 old URLs returned 000/404.
  • mvn -o test does not complete on this repo: the enforcer RequireNoRepositories rule rejects the pre-existing OSSRH snapshot <pluginRepositories> in pom.xml (removed in the separate build PR). There are no unit tests — surefire is skipped in this site POM.

@slachiewicz slachiewicz added the documentation Improvements or additions to documentation label Nov 18, 2026
The Codehaus license pages, SKS keyserver and OSSRH snapshot URLs no longer resolve. Point licensing, key distribution and snapshot instructions at the per-plugin LICENSE.txt, apache.org/licenses, keys.openpgp.org and Central's snapshot repository, and re-run the Spotless Markdown formatter so the tree passes spotless:check.
@slachiewicz
slachiewicz merged commit 3192856 into site Nov 19, 2026
5 checks passed
@slachiewicz
slachiewicz deleted the docs-fix-dead-links branch November 19, 2026 09:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant