Clean up mill comparison docs (#4773)

Author: lihaoyi

readme.adoc

@@ -25,17 +25,15 @@ https://central.sonatype.com/artifact/com.lihaoyi/mill-dist[image:https://img.sh
 Mill is a fast, scalable, multi-language build tool that supports Java, Scala,
 Kotlin, and Python:
 
-* Mill can build the same Java codebase 4-10x faster than Maven,
-or 2-4x faster than Gradle
+* Mill builds the same Java project 3-6x faster than Maven
+or Gradle due to aggressive caching & parallelism
 
-* Mill comes builtin with all the tools needed to develop and publish your project without
-needing plugins
+* Mill has better IDE support than other build tools, with
+superior autocomplete and navigation in IntelliJ
 
-* Mill's typed config language and immutable task graph
-helps keep builds clean and understandable
+* Mill builds require fewer plugins for common workflows,
+and are easier to extend with custom tasks
 
-* Mill scales well from small projects to
-large multi-language monorepos with hundreds of modules
 
 If you want to use Mill in your own projects, check out our documentation:
 

website/docs/modules/ROOT/images/comparisons/IntellijNettyAutocomplete.png

@@ -4,7 +4,7 @@
 
 https://mill-build.org/[Mill] is a JVM build tool that targets Java/Scala/Kotlin and has
 potential to serve the large-monorepo codebases that Bazel currently serves. Mill has good
-traction among its users, benchmarks that demonstrate 2-10x faster builds than its competitors,
+traction among its users, benchmarks that demonstrate 3-6x faster builds than its competitors,
 and a unique "direct-style" design that make it easy to use and extend. This page discusses
 some of the most interesting design decisions in Mill, and how it sets Mill apart from
 other build tools on the market.
@@ -80,7 +80,7 @@ had reached around 5-10% market share in the Scala community
 (https://www.jetbrains.com/lp/devecosystem-2023/scala/[Jetbrains Survey],
 https://scalasurvey2023.virtuslab.com/[VirtusLabs Survey]).
 It recently grew first-class Java support, demonstrating
-xref:comparisons/why-mill.adoc[2-10x speedups] over existing Java build tools
+xref:comparisons/why-mill.adoc[3-6x speedups] over existing Java build tools
 like Maven or Gradle. Mill also has gained experimental support for Java-adjacent platforms
 like xref:kotlinlib/intro.adoc[Kotlin] and
 xref:android/java.adoc[Android], and has demonstrated the ability to branch out into supporting
@@ -412,7 +412,7 @@ ecosystems rely on tools like Maven or Gradle to build their code, and I believe
 can provide a better alternative. Even today, there are already many advantages of
 using Mill over the incumbent build tools:
 
-1. Mill today runs the equivalent local workflows xref:comparisons/maven.adoc[4-10x faster than Maven]
+1. Mill today runs the equivalent local workflows xref:comparisons/maven.adoc[3-6x faster than Maven]
    and xref:comparisons/gradle.adoc[2-4x faster than Gradle], with automatic parallelization and caching for
    every part of your build
 

website/docs/modules/ROOT/images/comparisons/IntellijNettyDataflow.png

@@ -1,27 +1,21 @@
 = Mill: A Fast, Scalable JVM Build Tool
 
-
-
 https://github.com/com-lihaoyi/mill/blob/main/changelog.adoc[image:https://index.scala-lang.org/com-lihaoyi/mill/mill-main/latest.svg[Mill]]
 https://central.sonatype.com/artifact/com.lihaoyi/mill-dist[image:https://img.shields.io/maven-central/v/com.lihaoyi/mill-dist?label=latest-unstable&versionPrefix=0.12.[Maven Central Version]]
 
-Mill is a fast, scalable, multi-language build tool that supports Java, Scala,
-Kotlin:
+Mill is a fast JVM build tool that supports Java, Scala, and Kotlin:
 
-* Mill can build the same Java codebase xref:comparisons/maven.adoc[4-10x faster than Maven],
-or xref:comparisons/gradle.adoc[2-4x faster than Gradle]
+* Mill builds the same Java project xref:comparisons/maven.adoc[3-6x faster than Maven]
+xref:comparisons/gradle.adoc[or Gradle] due to aggressive caching & parallelism
 
-* Mill comes builtin with all the tools needed to develop and publish your project without
-needing plugins
+* Mill has better IDE support than other build tools, with
+superior autocomplete and navigation in IntelliJ
 
-* Mill's typechecked configuration and immutable xref:depth/design-principles.adoc[task graph]
-helps keep builds clean and understandable
-
-* Mill scales well from small projects to
-xref:large/large.adoc[large multi-language monorepos] with hundreds of modules
+* Mill builds require fewer plugins for common workflows,
+and are easier to extend with custom tasks
 
 To get started using Mill for the first time, or migrating and existing JVM
-codebase (build using Maven, Gradle, or SBT) to Mill, see:
+codebase (built using Maven, Gradle, or SBT) to Mill, see:
 
 [cols="1a,1a"]
 |===
@@ -37,8 +31,6 @@ Or see the language-specific introductory documentation linked below:
 | xref:kotlinlib/intro.adoc[image:index/iconscout-kotlin.svg[kotlin,28] Kotlin with Mill]
 |===
 
-If you want to use Mill on an existing codebase, see xref:migrating/migrating.adoc[]
-
 === Why Mill?
 
 Although the Java compiler is very fast and the Java language is easy to learn,
@@ -47,7 +39,7 @@ offer a better alternative, letting your build system take full advantage of the
 Java platform's performance and usability:
 
 * *Performance*: Mill automatically xref:depth/execution-model.adoc#_caching_in_mill[caches]
-and xref:cli/flags.adoc#_jobs_j[parallelizes] build tasks https://mill-build.org/blog/11-jvm-test-parallelism.html[and tests]
+and xref:depth/parallelism.adoc[parallelizes build tasks] and https://mill-build.org/blog/11-jvm-test-parallelism.html[tests]
 to keep local development fast, https://mill-build.org/blog/9-mill-faster-assembly-jars.html[incrementally builds assembly jars]
 to speed up manual testing workflows, and shortens CI times with xref:large/selective-execution.adoc[selective test execution]
 to only runs the subset of tests necessary to validate a code change.
@@ -77,6 +69,11 @@ use Mill's rich ecosystem of xref:extending/thirdparty-plugins.adoc[Third-Party
 or xref:extending/writing-plugins.adoc[write plugins yourself] and
 publish them to Maven Central for others to use.
 
+* *Scalability* Mill scales well from small projects to
+xref:large/large.adoc[large monorepos] with hundreds of modules and
+xref:large/multi-language-builds.adoc[multiple languages].
+Even projects with hundreds or thousands of sub-modules can be handled performantly
+and with minimal overhead.
 
 For a quick introduction of why you may care about Mill, see:
 

website/docs/modules/ROOT/images/comparisons/IntellijNettyDataflow2.png

@@ -16,4 +16,6 @@ that can be utilized to help you manage the build system of a large project or c
 
 * xref:large/selective-execution.adoc[]
 
-* xref:large/multi-file-builds.adoc[]
+* xref:large/multi-file-builds.adoc[]
+
+* xref:large/multi-language-builds.adoc[]