From 5f539aba120c9639ff861eba9ab712e1813caad5 Mon Sep 17 00:00:00 2001
From: Sylwester Lachiewicz <slachiewicz@apache.org>
Date: Mon, 10 Aug 2026 01:28:42 +0200
Subject: [PATCH] Restore the common wording on the download page

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)
---
 src/site/xdoc/download.xml.vm | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/src/site/xdoc/download.xml.vm b/src/site/xdoc/download.xml.vm
index 1e1e6a36..46b93e62 100644
--- a/src/site/xdoc/download.xml.vm
+++ b/src/site/xdoc/download.xml.vm
@@ -29,14 +29,14 @@ under the License.
 
       <p><strong>${project.name} ${project.version}</strong> is distributed in source format.</p>
 
-      <p>Use a source archive if you want to build ${project.name} yourself.</p>
+      <p>Use a source archive if you intend to build <strong>${project.name}</strong> yourself.</p>
 
-      <p>Otherwise, use the ready-made binary artifacts from the central repository.</p>
+      <p>Otherwise, simply use the ready-made binary artifacts from <strong>central repository</strong>.</p>
 
       <p><strong>${project.name}</strong> is distributed under the <a href="https://www.apache.org/licenses/">Apache License, version 2.0</a>.</p>
 
       <subsection name="Files">
-        
+
         <p>This is the current stable version of <strong>${project.name}</strong>.</p>
 
         <table>
@@ -58,16 +58,17 @@ under the License.
           </tbody>
         </table>
 
-        <p>You must verify the integrity of the downloaded file using the checksum (.sha512 file) or using the signature (.asc file).</p>
-        <p>Use the public KEYS that Apache Maven developers provide to verify.</p>
+        <p>It is essential that you <a href="https://www.apache.org/info/verification.html">verify the integrity</a> of the downloaded file
+          using the checksum (.sha512 file)
+          or using the signature (.asc file) against the public <a href="https://downloads.apache.org/maven/KEYS">KEYS</a> used by the Apache Maven developers.
+        </p>
 
       </subsection>
 
       <subsection name="Previous Versions">
-        <p>You must use the latest release version of ${project.name} to get new features and bug fixes.</p>
-        <p>Older releases exist on the archive site. These releases are not recommended.</p>
+        <p>It is strongly recommended to use the latest release version of <strong>${project.name}</strong> to take advantage of the newest features and bug fixes.</p>
+        <p>Older non-recommended releases can be found on our <a href="https://archive.apache.org/dist/maven/shared/">archive site</a>.</p>
       </subsection>
     </section>
   </body>
 </document>
-