diff --git a/MIGRATION.md b/MIGRATION.md
index c9e38e23b..34f1c5c14 100644
--- a/MIGRATION.md
+++ b/MIGRATION.md
@@ -1,11 +1,16 @@
 Migration notes
 ===============
 
-- `project/Build.scala` style based on `sbt.Build` is removed. Migrate to `build.sbt`.
-- `Project(...)` constructor is limited to just two parameters.
+- Build definition is based on Scala 2.11.8
+- Build.scala style builds are gone. Use multi-project `build.sbt`.
+- `Project(...)` constructor is restricted down to two parameters. Use `project` instead.
+- `sbt.Plugin` is also gone. Use auto plugins.
+- The incremental compiler, called Zinc, is uses class-based name hashing.
+- Zinc drops support for Scala 2.8.x and 2.9.x.
 
-- change import in auto plugin to:
+#### Additional import required
 
-```scala
-import sbt._, syntax._, Keys._
-```
+Implicit conversions are moved to `sbt.syntax`. Add the following imports to auto plugins
+or `project/*.scala`.
+
+    import sbt._, syntax._, Keys._
diff --git a/notes/1.0.0-M1.markdown b/notes/1.0.0-M1.markdown
new file mode 100644
index 000000000..f619bddb5
--- /dev/null
+++ b/notes/1.0.0-M1.markdown
@@ -0,0 +1,23 @@
+This is the first milestone (beta) release of sbt 1.0.
+There's no binrary compatibility with sbt 0.13 or other future versions.
+
+The biggest change in sbt 1.0 from 0.13 is internal code reorganization to modules
+(io, util, librarymanagement, zinc, and sbt), but hopefully this shouldn't affect you much.
+In addition, classes and objects related to internal implemetations are moved to `sbt.internal`.
+This package indicates that we won't keep binary compatibility for them.
+
+Here are some more relevant changes:
+
+- Build definition is based on Scala 2.11.8
+- Build.scala style builds are gone. Use multi-project `build.sbt`.
+- `Project(...)` constructor is restricted down to two parameters. Use `project` instead.
+- `sbt.Plugin` is also gone. Use auto plugins.
+- The incremental compiler, called Zinc, is uses class-based name hashing.
+- Zinc drops support for Scala 2.8.x and 2.9.x.
+
+#### Additional import required
+
+Implicit conversions are moved to `sbt.syntax`. Add the following imports to auto plugins
+or `project/*.scala`.
+
+    import sbt._, syntax._, Keys._