diff --git a/docs/index.md b/docs/index.md
index 436bf1c..4e0d9be 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -25,6 +25,7 @@
 :maxdepth: 1
 :glob:
 
+pages/*
 ```
 
 ---
diff --git a/docs/pages/migrating.md b/docs/pages/migrating.md
new file mode 100644
index 0000000..5398c1a
--- /dev/null
+++ b/docs/pages/migrating.md
@@ -0,0 +1,5 @@
+# Migrating to octodns
+
+```{include} ../../examples/migrating-to-octodns/README.md
+
+```