Skip to content

Modernise the download page - #334

Merged
slachiewicz merged 1 commit into
masterfrom
modernize-download-page
Aug 10, 2026
Merged

Modernise the download page#334
slachiewicz merged 1 commit into
masterfrom
modernize-download-page

Conversation

@slachiewicz

@slachiewicz slachiewicz commented Aug 9, 2026

Copy link
Copy Markdown
Member

This page was last touched in 2018 and still carries the ASF mirror-selection form. The mirror network was retired in favour of a single CDN, so that form currently renders a "choose a mirror" dropdown offering exactly one entry, dlcdn.apache.org. The checksum, signature and KEYS links still point at www.apache.org/dist, which has been a 301 to downloads.apache.org for years.

This finishes, for this repo, the "Refresh download page" sweep started in 2023 that stopped part-way through the estate. The page now matches the form the majority of Maven components already use:

  • artifact from dlcdn.apache.org
  • .sha512 / .asc / KEYS from downloads.apache.org
  • older releases from archive.apache.org (and over https, not http)

Format is unchanged — this stays xdoc.

Rendered before/after

Built the site both ways and diffed the generated HTML.

Removed (all mirror-system leftovers): [preferred], [if-any logo/http/ftp/backup], the SelectMirror form, www.apache.org/mirrors/.
Added: the real dlcdn.apache.org artifact link — note the old page had no usable artifact href in the static HTML at all, only the [preferred] placeholder — plus https://www.apache.org/info/verification.html.

Headings and anchors: #Download_… and #Previous_Versions are unchanged. Two anchors do go away with the mirror section: #mirror and the version-numbered subsection anchor (#Apache_Maven_GPG_Plugin_3.2.9-SNAPSHOT), which is replaced by the stable #Files. The version-numbered one was never stable — it changed on every release — but #mirror was, so flagging it explicitly.

download.cgi is deliberately left in place.

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 bbd89f2 to d3d4e27 Compare August 9, 2026 23:20
@slachiewicz slachiewicz changed the title Convert the download page to Markdown and modernise its content Modernise the download page Aug 9, 2026
@slachiewicz
slachiewicz force-pushed the modernize-download-page branch from d3d4e27 to 04270d3 Compare August 9, 2026 23:28
This page was last touched in 2018 and still carried the ASF mirror-selection
form. The mirror network was retired in favour of a single CDN, so that form
now renders a "choose a mirror" dropdown offering exactly one entry,
dlcdn.apache.org. The checksum, signature and KEYS links still pointed at
www.apache.org/dist, which has been a 301 to downloads.apache.org for years.

The page now matches the form the majority of the Maven estate already uses,
finishing the sweep started in 2023 that stopped part-way through:

  - the artifact from dlcdn.apache.org
  - the .sha512, .asc and KEYS from downloads.apache.org
  - older releases from archive.apache.org

The ASF licence header is left exactly as it was. The rendered download.html
keeps the same headings and the same generated anchors, apart from the mirror
section that is being removed.

Generated-by: Claude Opus 5 (1M context)
@slachiewicz
slachiewicz force-pushed the modernize-download-page branch from 04270d3 to 6b7ab16 Compare August 10, 2026 00:04
@slachiewicz
slachiewicz marked this pull request as ready for review August 10, 2026 08:22
@slachiewicz
slachiewicz merged commit 3f7a92d into master Aug 10, 2026
37 of 38 checks passed
@slachiewicz
slachiewicz deleted the modernize-download-page branch August 10, 2026 20:58
@github-actions github-actions Bot added this to the 3.2.9 milestone Aug 10, 2026
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