docs: move migration docs into book

4 files changed, 14 insertions, 2 deletions

diff --git a/docs/ref/SUMMARY.md b/docs/ref/SUMMARY.md
index dabdcf1f..9cb0de6a 100644
--- a/docs/ref/SUMMARY.md
+++ b/docs/ref/SUMMARY.md
@@ -55,4 +55,9 @@
   - [BSD Socket (Experimental)](./tran/socket.md)
   - [UDP Transport (Experimental)](./tran/udp.md)
 
+- [Migration Guides](./migrate/index.md)
+
+  - [Migrating from NNG 1.x](./migrate/nng1.md)
+  - [Migrating from libnanomsg](./migrate/nanomsg.md)
+
 [Index](./indexing.md)
diff --git a/docs/ref/migrate/index.md b/docs/ref/migrate/index.md
new file mode 100644
index 00000000..29d2d893
--- /dev/null
+++ b/docs/ref/migrate/index.md
@@ -0,0 +1,7 @@
+# Migration Guides
+
+This section provides some guides to aid in migrating software from
+earlier versions _NNG_ or _libnanomsg_.
+
+- [Migrating from NNG 1.x](./migrate/nng1.md)
+- [Migrating from libnanomsg](./migrate/nanomsg.md)
diff --git a/docs/migrating/nanomsg.md b/docs/ref/migrate/nanomsg.md
index e4c7b184..e4c7b184 100644
--- a/docs/migrating/nanomsg.md
+++ b/docs/ref/migrate/nanomsg.md
diff --git a/docs/migrating/nng1.md b/docs/ref/migrate/nng1.md
index 9da86d48..6cf605f3 100644
--- a/docs/migrating/nng1.md
+++ b/docs/ref/migrate/nng1.md
@@ -5,8 +5,8 @@ This guide should help in migrating applications to use NNG 2.0.
 
 ## Nanomsg Compatibility
 
-Applications using the legacy `libnanomsg` API will have to be updated to native NNG interfaces.
-See the [Migration Guide for libnanomsg](nanomsg.md) for details.
+Applications using the legacy `libnanomsg` API will have to be updated to native _NNG_ interfaces.
+See the [Migrating From libnanomsg](nanomsg.md) chapter for details.
 
 ## Transport Specific Functions