diff --git a/book/en/src/migration.md b/book/en/deprecated/migration.md
similarity index 100%
rename from book/en/src/migration.md
rename to book/en/deprecated/migration.md
diff --git a/book/en/src/migration/migration_rtic.md b/book/en/deprecated/migration/migration_rtic.md
similarity index 100%
rename from book/en/src/migration/migration_rtic.md
rename to book/en/deprecated/migration/migration_rtic.md
diff --git a/book/en/src/migration/migration_v4.md b/book/en/deprecated/migration/migration_v4.md
similarity index 100%
rename from book/en/src/migration/migration_v4.md
rename to book/en/deprecated/migration/migration_v4.md
diff --git a/book/en/src/migration/migration_v5.md b/book/en/deprecated/migration/migration_v5.md
similarity index 100%
rename from book/en/src/migration/migration_v5.md
rename to book/en/deprecated/migration/migration_v5.md
diff --git a/book/en/src/SUMMARY.md b/book/en/src/SUMMARY.md
index ceed24e6a9..8b19bf1103 100644
--- a/book/en/src/SUMMARY.md
+++ b/book/en/src/SUMMARY.md
@@ -23,11 +23,12 @@
     <!-- - [`#[cfg(..)]` support](./by-example/tips.md) -->
 - [RTIC vs. the world](./rtic_vs.md)
 - [Awesome RTIC examples](./awesome_rtic.md)
-<!-- - [Migration Guides](./migration.md)
-  - [v1.0.x to v2.0.0](./migration/migration_v2.md)
-  - [v0.5.x to v1.0.x](./migration/migration_v5.md)
-  - [v0.4.x to v0.5.x](./migration/migration_v4.md)
-  - [RTFM to RTIC](./migration/migration_rtic.md) -->
+- [Migrating from v1.0.x to v2.0.0](./migration_v1_v2.md)
+  - [Rust Nightly & features](./migration_v1_v2/nightly.md)
+  - [Migrating to `rtic-monotonics`](./migration_v1_v2/monotonics.md)
+  - [Software tasks must now be `async`](./migration_v1_v2/async_tasks.md)
+  - [Using and understanding `rtic-sync`](./migration_v1_v2/rtic-sync.md)
+  - [A code example on migration](./migration_v1_v2/complete_example.md)
 - [Under the hood](./internals.md)
   - [Cortex-M architectures](./internals/targets.md)
   <!--- [Interrupt configuration](./internals/interrupt-configuration.md)-->
@@ -44,13 +45,4 @@
     - [Message passing & `capacity`](./by-example/message_passing.md)
     - [Task priorities](./by-example/app_priorities.md)
     - [Monotonic & `spawn_{at/after}`](./by-example/monotonic.md) 
-  -->
-
----
-
-- [Migrating from v1.0.x to v2.0.0](./migration/migration_v2.md)
-  - [Rust Nightly & features](./migration/migration_v2/nightly.md)
-  - [Migrating to `rtic-monotonics`](./migration/migration_v2/monotonics.md)
-  - [Software tasks must now be `async`](./migration/migration_v2/async_tasks.md)
-  - [Using and understanding `rtic-sync`](./migration/migration_v2/rtic-sync.md)
-  - [A code example on migration](./migration/migration_v2/complete_example.md)
\ No newline at end of file
+  -->
\ No newline at end of file
diff --git a/book/en/src/migration/migration_v2.md b/book/en/src/migration_v1_v2.md
similarity index 100%
rename from book/en/src/migration/migration_v2.md
rename to book/en/src/migration_v1_v2.md
diff --git a/book/en/src/migration/migration_v2/async_tasks.md b/book/en/src/migration_v1_v2/async_tasks.md
similarity index 100%
rename from book/en/src/migration/migration_v2/async_tasks.md
rename to book/en/src/migration_v1_v2/async_tasks.md
diff --git a/book/en/src/migration/migration_v2/complete_example.md b/book/en/src/migration_v1_v2/complete_example.md
similarity index 98%
rename from book/en/src/migration/migration_v2/complete_example.md
rename to book/en/src/migration_v1_v2/complete_example.md
index b68f1ef28f..dc29b2543c 100644
--- a/book/en/src/migration/migration_v2/complete_example.md
+++ b/book/en/src/migration_v1_v2/complete_example.md
@@ -87,7 +87,7 @@ mod app {
 # V2.0.0
 
 ``` rust
-{{ #include ../../../../../examples/stm32f3_blinky/src/main.rs }}
+{{ #include ../../../../examples/stm32f3_blinky/src/main.rs }}
 ```
 
 ## A diff between the two projects
diff --git a/book/en/src/migration/migration_v2/monotonics.md b/book/en/src/migration_v1_v2/monotonics.md
similarity index 100%
rename from book/en/src/migration/migration_v2/monotonics.md
rename to book/en/src/migration_v1_v2/monotonics.md
diff --git a/book/en/src/migration/migration_v2/nightly.md b/book/en/src/migration_v1_v2/nightly.md
similarity index 100%
rename from book/en/src/migration/migration_v2/nightly.md
rename to book/en/src/migration_v1_v2/nightly.md
diff --git a/book/en/src/migration/migration_v2/rtic-sync.md b/book/en/src/migration_v1_v2/rtic-sync.md
similarity index 100%
rename from book/en/src/migration/migration_v2/rtic-sync.md
rename to book/en/src/migration_v1_v2/rtic-sync.md