[PR] Reconcile the two download pages and modernise them [maven-doxia-sitetools]

["slachiewicz (via GitHub)" <gi...@apache.org>]

slachiewicz opened a new pull request, #670:
URL: https://github.com/apache/maven-doxia-sitetools/pull/670

   This repository carries **two** download pages from different generations: the root page in the current form, and `doxia-integration-tools/src/site/xdoc/download.xml.vm` still on the 2014 **mirror-selection form**, with its checksum and KEYS links pointing at `www.apache.org/dist` (a 301 to `downloads.apache.org` for years now).
   
   ### The module page advertised a file that does not exist
   
   It offered `doxia-integration-tools-${project.version}-source-release.zip`. **That has never been released.** `doxia-integration-tools` ships inside the `doxia-sitetools` source release and has no source bundle of its own — `https://downloads.apache.org/maven/doxia/` confirms it.
   
   Rather than making a wrong page prettier, the module page now points at the `doxia-sitetools` bundle that actually exists, and says so in a sentence, so a reader is not surprised by a page titled after the module offering an archive named after its parent. The URL stays live either way — it is reachable today and deleting it was not on the table.
   
   ### Also
   
   - Both pages brought to the form the rest of the Maven estate uses (finishing the sweep started in 2023 that stopped part-way through).
   - `www.apache.org/dist` → `downloads.apache.org` for checksums and KEYS.
   - **The ASF licence headers are left byte-for-byte as they were.** My first pass spliced in a canonical header and silently downgraded an `https://` LICENSE-2.0 URL to `http://`; the generator now preserves each file's existing preamble and never rewrites it.
   - The root page diff is whitespace only.
   
   ### Verification
   
   XML well-formedness checked on both files, and the new module page rendered through a site build to confirm the headings, the added sentence and the download row come out right. Local checks only — not claiming CI is green; draft until it is.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@maven.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] Reconcile the two download pages and modernise them [maven-doxia-sitetools]

["slachiewicz (via GitHub)" <gi...@apache.org>]

slachiewicz merged PR #670:
URL: https://github.com/apache/maven-doxia-sitetools/pull/670


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@maven.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org