diff --git a/UPGRADING.md b/UPGRADING.md
new file mode 100644
index 0000000..d97a6ea
--- /dev/null
+++ b/UPGRADING.md
@@ -0,0 +1,6 @@
+# Upgrading
+
+## v3.0.0
+
+- Move `build` block contents outside of `build` block and remove `build` call.
+- Replace `Environment.new()` calls with `env()`.