diff --git a/README.md b/README.md
index 294cfb6b..d8e08bb7 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,11 @@ find that parts of this documentation are likely still stuck on v2.
 For stable (and documentation-matching) version of Catch2, [go to the
 `v2.x` branch](https://github.com/catchorg/Catch2/tree/v2.x).
 
+For migrating from the v2 releases to v3, you should look at [our
+documentation](docs/migrate-v2-to-v3.md#top). It provides a simple
+guidelines on getting started, and collects most common migration
+problems.
+
 
 ## What's the Catch2?
 
diff --git a/docs/Readme.md b/docs/Readme.md
index 0bbb104e..821e6fca 100644
--- a/docs/Readme.md
+++ b/docs/Readme.md
@@ -34,6 +34,7 @@ FAQ:
  
 Other:
 * [Why Catch?](why-catch.md#top)
+* [Migrating from v2 to v3](migrate-v2-to-v3.md#top)
 * [Open Source Projects using Catch](opensource-users.md#top)
 * [Commercial Projects using Catch](commercial-users.md#top)
 * [Contributing](contributing.md#top)