docs

2 files changed, 11 insertions, 4 deletions

diff --git a/docs/pages/1 - Intro to Mill.md b/docs/pages/1 - Intro to Mill.md
index 37709c30..32fca7e8 100644
--- a/docs/pages/1 - Intro to Mill.md
+++ b/docs/pages/1 - Intro to Mill.md
@@ -1,5 +1,6 @@
-Mill is your shiny new Scala build tool! Confused by SBT? Frustrated by Maven?
-Perplexed by Gradle? Give Mill a try!
+Mill is your shiny new Scala build tool!
+[Confused by SBT](http://www.lihaoyi.com/post/SowhatswrongwithSBT.html)?
+Frustrated by Maven? Perplexed by Gradle? Give Mill a try!
 
 Mill is a general purpose build-tool. It has built in support for the
 [Scala](https://www.scala-lang.org/) programming language, and can serve as a
@@ -7,8 +8,10 @@ replacement for [SBT](http://www.scala-sbt.org/), but can also be extended to
 support any other language or platform via modules (written in Java or Scala) or
 through external subprocesses.
 
-Mill aims for simplicity by re-using concepts you are already familiar with to
-let you define your project's build. Mill's `build.sc` files are Scala scripts.
+Mill aims for simplicity by
+[re-using concepts you are already familiar with](http://www.lihaoyi.com/post/BuildToolsasPureFunctionalPrograms.html)
+to let you define your project's build. Mill's `build.sc` files are Scala
+scripts.
 
 To get started, download Mill and install it into your system via the following
 `curl`/`chmod` command:
diff --git a/docs/pages/6 - Extending Mill.md b/docs/pages/6 - Extending Mill.md
index 299d8e76..d5ec2dbc 100644
--- a/docs/pages/6 - Extending Mill.md
+++ b/docs/pages/6 - Extending Mill.md
@@ -64,6 +64,10 @@ def doWebpackStuff(webpackProcess: Process, sources: Seq[PathRef]): PathRef = ??
 def compiledJavascript = T{ doWebpackStuff(webpackWorker(), javascriptSources()) }
 ```
 
+Mill itself uses `T.worker`s for it's built-in Scala support: we keep the Scala
+compiler in memory between compilations, rather than discarding it each time, in
+order to improve performance.
+
 ## Custom Modules
 
 ```scala