diff --git a/build.sc b/build.sc
index d9b7c33a4db..39dd671f654 100755
--- a/build.sc
+++ b/build.sc
@@ -24,7 +24,10 @@ object Settings {
   // the exact branches containing a doc root
   val docBranches = Seq()
   // the exact tags containing a doc root
-  val docTags = Seq("0.9.6", "0.9.7", "0.9.8", "0.9.9")
+  val docTags = Seq(
+    "0.9.6", "0.9.7", "0.9.8", "0.9.9",
+    "0.10.0-M2"
+  )
 }
 
 object Deps {
diff --git a/docs/antora/antora.yml b/docs/antora/antora.yml
index 4adc728ea8a..b8758b3eec3 100644
--- a/docs/antora/antora.yml
+++ b/docs/antora/antora.yml
@@ -1,9 +1,9 @@
 name: mill
 title: Mill Documentation
-version: '0.9.9'
+version: '0.10.0-M2'
 nav:
   - modules/ROOT/nav.adoc
 asciidoc:
   attributes:
-    mill-version: '0.9.9'
-    mill-last-tag: '0.9.9'
+    mill-version: '0.10.0-M2'
+    mill-last-tag: '0.10.0-M2'
diff --git a/readme.adoc b/readme.adoc
index 4a832836ff9..1b0a49b5bbc 100644
--- a/readme.adoc
+++ b/readme.adoc
@@ -209,9 +209,35 @@ corresponding version of Mill.
 
 === main
 :version: main
+:prev-version: 0.10.0-M2
+:milestone: 53
+:milestone-name: 0.10.0-M3
+
+_Changes since {prev-version}:_
+
+_For details refer to
+{link-milestone}/{milestone}?closed=1[milestone {milestone-name}]
+and the {link-compare}/{prev-version}\...{version}[list of commits]._
+
+
+=== 0.10.0-M2 - 2021-09-17
+:version: 0.10.0-M2
 :prev-version: 0.9.9
 :milestone: 51
-:milestone-name: after 0.9.9
+:milestone-name: 0.10.0-M2
+
+*This is a early milestone release.
+This release breaks binary compatibility for external plugins build for mill 0.9.x.
+The API is suspected to change before a 0.10.0 releae.*
+
+_Changes since {prev-version}:_
+
+* Removed deprecated API
+* `ScalaModule`: added `mandatoryScalacOptions` to avoid the common issue that users forget to include mandatory options when defining their own.
+* Renamed `toolsClasspath` targets found in various modules to avoid hard to resolve clashes when mixing traits
+* Fixed and improved our test suite on Windows
+* Various fixes and improvements
+* Various dependency updates
 
 
 _For details refer to
@@ -225,6 +251,8 @@ and the {link-compare}/{prev-version}\...{version}[list of commits]._
 :milestone: 50
 :milestone-name: 0.9.9
 
+_Changes since {prev-version}:_
+
 * BSP: Fixed/improved source item for root project
 * Bloop: Prevent compilation during bloop config generation
 * GenIdea: Fix content path of root project (mill-build)
@@ -241,6 +269,8 @@ and the {link-compare}/{prev-version}\...{version}[list of commits]._
 :milestone: 49
 :milestone-name: 0.9.8
 
+_Changes since {prev-version}:_
+
 * Fixed some potential binary incompatibilities with external plugins (builds against older os-lib versions)
 * Fixed location and configuration of mills home path (used for caching of build scripts)
 * Properly close jar resources - should fix issues in `assembly`, esp. on Windows where open resources are locked
@@ -260,6 +290,8 @@ and the {link-compare}/{prev-version}\...{version}[list of commits]._
 :milestone: 48
 :milestone-name: 0.9.7
 
+_Changes since {prev-version}:_
+
 * `ScalaModule`: Support for Scala 3
 * `CoursierModule`: Support customized dependency resolution (needed to work with ScalaFX)
 * `TestModule`: Added new `testFramework` target and only support one test framework. Deprecated `testFrameworks` targets.