From 6e4e2843eddbdb87c33f4a678608340aedc5757f Mon Sep 17 00:00:00 2001 From: opencode Date: Fri, 31 Jul 2026 21:48:24 +0000 Subject: [PATCH] Rewrite documentation per ASD-STE100 Simplified Technical English --- src/site/xdoc/download.xml.vm | 36 ++++++++++++++--------------------- 1 file changed, 14 insertions(+), 22 deletions(-) diff --git a/src/site/xdoc/download.xml.vm b/src/site/xdoc/download.xml.vm index 666d997..1e2d103 100644 --- a/src/site/xdoc/download.xml.vm +++ b/src/site/xdoc/download.xml.vm @@ -26,20 +26,15 @@ under the License.
-

${project.name} ${project.version} is distributed in source format. Use a source archive if you intend to build - ${project.name} yourself. Otherwise, simply use the ready-made binary artifacts from central repository.

+

${project.name} ${project.version} distributes source code. Use a source archive if you want to build ${project.name}. Otherwise, use binary artifacts from the central repository.

-

You will be prompted for a mirror - if the file is not found on yours, please be patient, as it may take 24 - hours to reach all mirrors.

+

The system prompts for a mirror. If the file does not exist on your mirror, wait. Mirrors take up to 24 hours to update.

-

In order to guard against corrupted downloads/installations, it is highly recommended to - verify the signature - of the release bundles against the public KEYS used by the Apache Maven - developers.

+

To guard against corrupted downloads or installations, verify the signature of release bundles. Use the public KEYS that Apache Maven developers provide.

-

${project.name} is distributed under the Apache License, version 2.0.

+

${project.name} uses the Apache License, version 2.0.

-

We strongly encourage our users to configure a Maven repository mirror closer to their location, please read How to Use Mirrors for Repositories.

+

We encourage users to configure a Maven repository mirror. Choose a mirror close to your location. Read the guide about mirror settings for repositories.

@@ -51,14 +46,13 @@ under the License. alt="logo"/> [end] - The currently selected mirror is + The current mirror is [preferred]. - If you encounter a problem with this mirror, - please select another mirror. - If all mirrors are failing, there are + If you face a problem with this mirror, + choose another mirror. + If all mirrors fail, use backup - mirrors - (at the end of the mirrors list) that should be available. + mirrors at the end of the list.

@@ -84,9 +78,8 @@ under the License.

- You may also consult the - complete list of - mirrors. + You can read the + complete mirror list.

@@ -117,10 +110,9 @@ under the License. -

Older non-recommended releases can be found on our archive site.

+

Older releases exist on the archive site. These releases are not recommended.
- - + \ No newline at end of file