diff --git a/template-transition-notes b/template-transition-notes
new file mode 100644
index 000000000..193dd79d4
--- /dev/null
+++ b/template-transition-notes
@@ -0,0 +1,5 @@
+* add_templates option removed from underlay plugin
+  (can use add_underlays instead)
+* includes no longer allowed in templates
+* template directive no longer uses $foo.tmpl , only
+  page $foo.