diff --git a/UPGRADING.md b/UPGRADING.md
new file mode 100644
index 0000000..119d305
--- /dev/null
+++ b/UPGRADING.md
@@ -0,0 +1,12 @@
+Upgrading
+----------
+
+non-backward compatible changes introduced by #81
+-------------------------------------------------- 
+
+- bootstrap-cfn has a new required boolean field for enabling RDS encryption. The following needs to be added to the cloudformation yaml file for all previously built projects:
+
+```bash
+  rds:
+    storage-encrypted: False
+```