diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm index 18ce0563..6fde828b 100644 --- a/src/site/apt/index.apt.vm +++ b/src/site/apt/index.apt.vm @@ -29,14 +29,11 @@ ${project.name} - This project aims to be a functional replacement for - {{{https://codehaus-plexus.github.io/plexus-utils/}plexus-utils}} in Maven. - - It is not a 100% API compatible replacement though but a replacement : - lots of methods got cleaned up, generics got added and we dropped a lot of unused code. + This project replaces {{{https://codehaus-plexus.github.io/plexus-utils/}plexus-utils}} for Maven. - Then there are additions, like - {{{./apidocs/org/apache/maven/shared/utils/logging/package-summary.html}styled message API}}. + It is not a 100% API compatible replacement. We cleaned up methods, added generics, and removed unused code. + + This project adds new features, like {{{./apidocs/org/apache/maven/shared/utils/logging/package-summary.html}styled message API}}. Why? @@ -45,8 +42,6 @@ Why? Why not commons? - We would prefer code to use commons-* where appropriate, but plexus-utils became - slightly incompatible from the Commons versions over the years, so migrating is not - always a 1:1 operation. Migrating to Maven Shared Utils is a 1:1 operation in most cases. + We prefer code to use commons-* where appropriate. The plexus-utils versions became incompatible with the Commons versions over time. Migrating is not always a 1:1 operation. Migrating to Maven Shared Utils works in most cases as a 1:1 operation. [] diff --git a/src/site/xdoc/download.xml.vm b/src/site/xdoc/download.xml.vm index 2b848a91..1e1e6a36 100644 --- a/src/site/xdoc/download.xml.vm +++ b/src/site/xdoc/download.xml.vm @@ -29,9 +29,9 @@ under the License.

${project.name} ${project.version} is distributed in source format.

-

Use a source archive if you intend to build ${project.name} yourself.

+

Use a source archive if you want to build ${project.name} yourself.

-

Otherwise, simply use the ready-made binary artifacts from central repository.

+

Otherwise, use the ready-made binary artifacts from the central repository.

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

@@ -58,16 +58,14 @@ under the License. -

It is essential that you verify the integrity of the downloaded file - using the checksum (.sha512 file) - or using the signature (.asc file) against the public KEYS used by the Apache Maven developers. -

+

You must verify the integrity of the downloaded file using the checksum (.sha512 file) or using the signature (.asc file).

+

Use the public KEYS that Apache Maven developers provide to verify.

-

It is strongly recommended to use the latest release version of ${project.name} to take advantage of the newest features and bug fixes.

-

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

+

You must use the latest release version of ${project.name} to get new features and bug fixes.

+

Older releases exist on the archive site. These releases are not recommended.