Skip to content

Restore the common wording on the download page - #421

Closed
slachiewicz wants to merge 1 commit into
masterfrom
modernize-download-page
Closed

Restore the common wording on the download page#421
slachiewicz wants to merge 1 commit into
masterfrom
modernize-download-page

Conversation

@slachiewicz

@slachiewicz slachiewicz commented Aug 9, 2026

Copy link
Copy Markdown
Member

The wording on this page had drifted from the text the rest of the Maven estate uses. This restores the shared wording so the page is identical to its counterparts apart from the distribution area and the artifact name.

Format is unchanged — this stays xdoc.

This is not purely cosmetic

Diffing the rendered HTML before and after shows the reworded version had silently dropped three hyperlinks, leaving the text as plain prose:

  • https://www.apache.org/info/verification.html (how to verify a download)
  • https://downloads.apache.org/maven/KEYS (the signing keys)
  • https://archive.apache.org/dist/maven/…/ (the archive site)

Restoring the common wording restores all three.

Headings, generated anchors (#Files, #Previous_Versions) and the table are unchanged, so no URL and no in-page anchor moves.

Verified by local site build and HTML diff only — not claiming CI is green; draft until it is.


Licence header: left byte-for-byte as it was. My first pass spliced in a canonical header and silently downgraded an https:// LICENSE-2.0 URL to http:// in a sibling repo; the generator now preserves each file's existing preamble and never rewrites it.

Format: this stays xdoc. Converting the page to Markdown was evaluated separately and shown to round-trip losslessly, and was then deliberately declined — noting that here so the question does not get reopened from scratch later.

@slachiewicz slachiewicz added the documentation Improvements or additions to documentation label Aug 9, 2026
@slachiewicz
slachiewicz force-pushed the modernize-download-page branch from 95b6bd8 to 2ae7890 Compare August 9, 2026 23:20
@slachiewicz slachiewicz changed the title Convert the download page to Markdown Restore the common wording on the download page Aug 9, 2026
@slachiewicz
slachiewicz force-pushed the modernize-download-page branch from 2ae7890 to 5afaf24 Compare August 9, 2026 23:28
The wording here had drifted from the text the rest of the Maven estate uses.
This restores the shared form so the page is identical to its counterparts
apart from the distribution area and the artifact name.

Comparing the rendered HTML before and after shows the reworded version had
dropped three links, leaving the text as plain prose: the verification
instructions, the KEYS file and the archive site. Restoring the common
wording restores all three.

The ASF licence header is left exactly as it was.

Generated-by: Claude Opus 5 (1M context)
@slachiewicz
slachiewicz force-pushed the modernize-download-page branch from 5afaf24 to 5f539ab Compare August 10, 2026 00:07

@elharo elharo left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The change you're trying to revert was a deliberate improvement.

@slachiewicz
slachiewicz deleted the modernize-download-page branch August 10, 2026 20:34
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.

2 participants