Overhaul docs for The Mill Evaluation Model (#4156)

Renovated it to freshen it up: diagrams, cross-links, and general cleanup. Also renamed it `The Mill Execution Model` to avoid confusion with the `Evaluation` phase in Mill Fixes #4114
com-lihaoyi · Dec 18, 2024 · cd89946 · cd89946
1 parent c72ace7
commit cd89946
Show file tree

Hide file tree

Showing 6 changed files with 430 additions and 151 deletions.
diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc
@@ -100,7 +100,7 @@
 
 * Mill In Depth
 ** xref:depth/sandboxing.adoc[]
-** xref:depth/evaluation-model.adoc[]
+** xref:depth/execution-model.adoc[]
 ** xref:depth/design-principles.adoc[]
 ** xref:depth/why-scala.adoc[]
 // Reference pages that a typical user would not typically read top-to-bottom,

diff --git a/docs/modules/ROOT/pages/comparisons/gradle.adoc b/docs/modules/ROOT/pages/comparisons/gradle.adoc
@@ -18,7 +18,7 @@ does so with much less fixed overhead. This means less time waiting for your bui
 tool, and more time for the things that really matter to your project.
 
 * **Mill enforces best practices by default**.
-xref:depth/evaluation-model.adoc#_caching_at_each_layer_of_the_evaluation_model[All parts of a Mill build are cached and incremental by default].
+xref:depth/execution-model.adoc#_caching_in_mill[All parts of a Mill build are cached and incremental by default].
 All Mill tasks write their output to xref:fundamentals/out-dir.adoc[a standard place].
 All task inter-dependencies are automatically captured without manual annotation. Where Gradle requires
 considerable effort and expertise to understand your build and set it up in the right way, Mill's

diff --git a/docs/modules/ROOT/pages/comparisons/unique.adoc b/docs/modules/ROOT/pages/comparisons/unique.adoc
@@ -480,7 +480,7 @@ functionality, but at 10% the complexity:
 * Bazel itself is not getting any simpler over time - instead is getting more complex with
   additional features and functionality, as tends to happen to projects over time
 
-Mill provides many of the same things Bazel does: automatic xref:depth/evaluation-model.adoc[caching],
+Mill provides many of the same things Bazel does: automatic xref:depth/execution-model.adoc[caching],
 parallelization, xref:depth/sandboxing.adoc[sandboxing],
 xref:extending/import-ivy-plugins.adoc[extensibility]. Mill
 can already work with a wide variety of programming languages,

diff --git a/docs/modules/ROOT/pages/depth/evaluation-model.adoc b/docs/modules/ROOT/pages/depth/evaluation-model.adoc