Added module docs for selective execution

example/large/selective/9-selective-execution/build.mill

@@ -10,11 +10,11 @@
 //
 // * `mill selective.run <selector>`: run on the codebase after the code change,
 // runs tasks in the given `<selector>` which are affected by the code changes
-// that have happen since `selective.prepare` was run
+// that have happened since `selective.prepare` was run
 //
 // * `mill selective.resolve <selector>`: a dry-run version of `selective.run`, prints
 // out the tasks in `<selector>` that are affected by the code changes and would have
-// run, without actually tunning them.
+// run, without actually running them.
 //
 // For example, if you want to run all tests related to the code changes in a pull
 // request branch, you can do that as follows:

main/src/mill/main/MainModule.scala

@@ -304,7 +304,25 @@ trait MainModule extends BaseModule {
 
   /**
    * Commands related to selective execution, where Mill runs tasks selectively
-   * depending on what task inputs or implementations changed
+   * depending on what task inputs or implementations changed.
+   *
+   * Read more about it at: https://mill-build.org/mill/large/selective-execution.html
+   *
+   * Here are the essential commands:
+   *
+   * - `mill selective.prepare <selector>`:
+   *   run on the codebase before the code change,
+   *   stores a snapshot of task inputs and implementations
+   *
+   * - `mill selective.run <selector>`:
+   *   run on the codebase after the code change,
+   *   runs tasks in the given `<selector>` which are affected by the code changes
+   *   that have happened since `selective.prepare` was run
+   *
+   * - `mill selective.resolve <selector>`:
+   *   a dry-run version of `selective.run`,
+   *   prints out the tasks in `<selector>`` that are affected by the code changes
+   *   and would have run, without actually running them.
    */
   lazy val selective: SelectiveExecutionModule = new SelectiveExecutionModule {}
 

main/src/mill/main/SelectiveExecutionModule.scala

@@ -6,6 +6,27 @@ import mill.define.{Command, Task}
 import mill.eval.{Evaluator, SelectiveExecution}
 import mill.define.SelectMode
 
+/**
+ * Mill Module to support selective test execution in large projects.
+ *
+ * Read more about it at: https://mill-build.org/mill/large/selective-execution.html
+ *
+ * Here are the essential commands:
+ *
+ * - `mill selective.prepare <selector>`:
+ *   run on the codebase before the code change,
+ *   stores a snapshot of task inputs and implementations
+ *
+ * - `mill selective.run <selector>`:
+ *   run on the codebase after the code change,
+ *   runs tasks in the given `<selector>` which are affected by the code changes
+ *   that have happened since `selective.prepare` was run
+ *
+ * - `mill selective.resolve <selector>`:
+ *   a dry-run version of `selective.run`,
+ *   prints out the tasks in `<selector>`` that are affected by the code changes
+ *   and would have run, without actually running them.
+ */
 trait SelectiveExecutionModule extends mill.define.Module {
 
   /**