From 5ec663de559a6fe9133044b33d39059aff74e8d0 Mon Sep 17 00:00:00 2001
From: Sylwester Lachiewicz <slachiewicz@apache.org>
Date: Mon, 10 Aug 2026 01:39:34 +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.

Rewording elsewhere in the estate had silently dropped links, leaving the text
as plain prose, so this is not purely cosmetic.

No URL or in-page anchor changes. The ASF licence header is left exactly as
it was.

Generated-by: Claude Opus 5 (1M context)
---
 src/site/xdoc/download.xml.vm | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/site/xdoc/download.xml.vm b/src/site/xdoc/download.xml.vm
index 7340c16..1d482d3 100644
--- a/src/site/xdoc/download.xml.vm
+++ b/src/site/xdoc/download.xml.vm
@@ -29,9 +29,9 @@ under the License.
 
       <p><strong>${project.name} ${project.version}</strong> is distributed in source format.</p>
 
-      <p>Use a source archive to build <strong>${project.name}</strong> 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 <strong>central repository</strong>.</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>
 
@@ -58,16 +58,16 @@ under the License.
           </tbody>
         </table>
 
-        <p>Verify the integrity of the downloaded file. Use the checksum
-          (.sha512 file) or the signature (.asc file). Verify the signature
-          against the public <a href="https://downloads.apache.org/maven/KEYS">KEYS</a> used by the Apache Maven developers.
+        <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>Use the latest release version of <strong>${project.name}</strong>. The latest version has the newest features and bug fixes.</p>
-        <p>You can find older releases on the <a href="https://archive.apache.org/dist/maven/plugins/">archive site</a>.</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/plugins/">archive site</a>.</p>
       </subsection>
     </section>
   </body>