diff --git a/Migrating-to-reveal.js-3.0.0.md b/Migrating-to-reveal.js-3.0.0.md
new file mode 100644
index 0000000..712780c
--- /dev/null
+++ b/Migrating-to-reveal.js-3.0.0.md
@@ -0,0 +1,23 @@
+This is a draft, 3.0.0 is not yet released.
+
+----
+
+reveal.js 3.0.0 is structurally not dramatically different than the 2.X.X versions but there have been some changes worth pointing out.
+
+### New default theme
+The original reveal.js theme has been replaced with a new theme called 'black'. The previous default theme is now called 'league'. To change back to the old default replace the following in index.html:
+```html
+
+```
+
+with
+
+```html
+
+```
+
+### New default transition
+A sliding transition replaces the previous 3D rotation effect. If you want to stick to the old transition you'll need to specify `transition: concave` when initializing reveal.js.
+
+### No more minifies files
+reveal.min.js and reveal.min.css are no longer tracked in the repository, to generate them you'll need to have Grunt running locally. This is covered in the [readme](https://github.com/hakimel/reveal.js#full-setup).
\ No newline at end of file