Re: [PR] Improve README documentation clarity [maven]

[via GitHub]

elharo commented on code in PR #11682:
URL: https://github.com/apache/maven/pull/11682#discussion_r2804008723


##########
README.md:
##########
@@ -19,23 +19,14 @@ Apache Maven
 
 [![Apache License, Version 2.0, January 
2004](https://img.shields.io/github/license/apache/maven.svg?label=License)][license]
 [![Reproducible 
Builds](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/jvm-repo-rebuild/reproducible-central/master/content/org/apache/maven/maven/badge.json)](https://github.com/jvm-repo-rebuild/reproducible-central/blob/master/content/org/apache/maven/maven/README.md)
+- [master](https://github.com/apache/maven) = 4.1.x: [![Maven 
Central](https://img.shields.io/maven-central/v/org.apache.maven/apache-maven.svg?label=Maven%20Central)](https://central.sonatype.com/artifact/org.apache.maven/apache-maven)
+[![Jenkins 
Status](https://img.shields.io/jenkins/s/https/ci-maven.apache.org/job/Maven/job/maven-box/job/maven/job/master.svg?)][build]
+[![Jenkins 
tests](https://img.shields.io/jenkins/t/https/ci-maven.apache.org/job/Maven/job/maven-box/job/maven/job/master.svg?)][test-results]
+- [4.0.x](https://github.com/apache/maven/tree/maven-4.0.x): [![Maven 
Central](https://img.shields.io/maven-central/v/org.apache.maven/apache-maven.svg?label=Maven%20Central&versionPrefix=4.0)](https://central.sonatype.com/artifact/org.apache.maven/apache-maven)
+- [3.9.x](https://github.com/apache/maven/tree/maven-3.9.x): [![Maven 
Central](https://img.shields.io/maven-central/v/org.apache.maven/apache-maven.svg?label=Maven%20Central&versionPrefix=3.)](https://central.sonatype.com/artifact/org.apache.maven/apache-maven)
 
-- [master](https://github.com/apache/maven) = 4.1.x
-[![Jenkins 
Build](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci-maven.apache.org%2Fjob%2FMaven%2Fjob%2Fmaven-box%2Fjob%2Fmaven%2Fjob%2Fmaster%2F)
-  ][build]
-[![Java 
CI](https://github.com/apache/maven/actions/workflows/maven.yml/badge.svg?branch=master)][gh-build]
 
-- [4.0.x](https://github.com/apache/maven/tree/maven-4.0.x): 
-[![Maven 
Central](https://img.shields.io/maven-central/v/org.apache.maven/apache-maven.svg?label=Maven%20Central&versionPrefix=4.0)](https://central.sonatype.com/artifact/org.apache.maven/apache-maven)
-[![Jenkins 
Build](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci-maven.apache.org%2Fjob%2FMaven%2Fjob%2Fmaven-box%2Fjob%2Fmaven%2Fjob%2Fmaven-4.0.x%2F)][build-4.0]
-[![Java 
CI](https://github.com/apache/maven/actions/workflows/maven.yml/badge.svg?branch=maven-4.0.x)][gh-build-4.0]
-
-- [3.9.x](https://github.com/apache/maven/tree/maven-3.9.x): 
-[![Maven 
Central](https://img.shields.io/maven-central/v/org.apache.maven/apache-maven.svg?label=Maven%20Central&versionPrefix=3.)](https://central.sonatype.com/artifact/org.apache.maven/apache-maven)
-![Jenkins 
Build](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci-maven.apache.org%2Fjob%2FMaven%2Fjob%2Fmaven-box%2Fjob%2Fmaven%2Fjob%2Fmaven-3.9.x%2F)
-[![Java 
CI](https://github.com/apache/maven/actions/workflows/maven.yml/badge.svg?branch=maven-3.9.x)][gh-build-3.9]
-
-Apache Maven is a software project management and comprehension tool. Based on
+Apache Maven is a software project management and build automation tool. Based 
on

Review Comment:
   We've discussed it before. I'd prefer not to let the perfect be the enemy of 
the good. Fixing one awkward, unclear doc out of 100 is better than leaving it 
alone while we figure out how to fix the other 99. Since we're not a mono-repo 
we'll never fix them all at the same time anyway.



-- 
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-unsubscr...@maven.apache.org

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