Skip to content

Modernise the download page - #61

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

Modernise the download page#61
slachiewicz wants to merge 1 commit into
masterfrom
modernize-download-page

Conversation

@slachiewicz

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 repository, the "Refresh download page" sweep started in 2023 that stopped part-way through the estate. About 43 repositories are already on this exact form.

  • artifact from dlcdn.apache.org — note the current page has no usable artifact href at all in the static HTML, only the [preferred] placeholder, which resolves solely when served through mirrors.cgi
  • .sha512 / .asc / KEYS from downloads.apache.org
  • older releases from archive.apache.org, over https

Two removals worth your attention

  1. In-page anchors. #mirror and the version-numbered subsection anchor go away with the mirror section; the latter becomes the stable #Files. In-page only — no URL changes. You cannot delete the section and keep its anchor meaningfully.
  2. The /guides/mini/guide-mirror-settings.html paragraph. That page is still live, but it is advice about configuring a repository mirror in settings.xml, not about downloading a source release, and none of the repositories already on the current form carry it. Dropping it is what converges this page with the rest of the estate — but say so on this PR if you would rather keep it here.

download.cgi is left in place: it is the canonical download URL for every component (download.html 301-redirects into it via a site-wide rule in apache/maven-site's .htaccess), so removing it would 404 the download page.

The ASF licence header is left byte-for-byte as it was.

Verification

Generated from a single canonical template that reproduces the existing form exactly; XML well-formedness checked, and a link-set audit run across all repositories in this sweep to confirm nothing is lost beyond the mirror-system leftovers listed above. Representative repositories were rendered before and after with a real site build. This specific repository was not individually rendered — flagging that rather than implying otherwise. Draft until CI is green.

@slachiewicz slachiewicz added the documentation Improvements or additions to documentation label Aug 9, 2026
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 rest of the Maven estate already uses,
finishing for this repository the sweep started in 2023:

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

Two things go with the mirror section, both worth a reviewer's attention:

  - its in-page anchors, #mirror and the version-numbered subsection anchor,
    which becomes the stable #Files. In-page only; no URL changes.
  - the paragraph linking to /guides/mini/guide-mirror-settings.html. That
    page is still live, but it is advice about configuring a repository
    mirror in settings.xml rather than about downloading a source release,
    and none of the ~43 repositories already on the current form carry it.
    Dropping it is what converges this page with the rest of the estate; say
    so on the PR if you would rather keep it here.

download.cgi is left in place. 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 68038f7 to f64be59 Compare August 10, 2026 00:06
@slachiewicz
slachiewicz marked this pull request as ready for review August 10, 2026 08:22
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