diff --git a/README.md b/README.md
index fac8663cb5..747d482566 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,8 @@ emulators, and popular games including Valve's award winning catalog
 and many Humble Bundle games.
 
 More extensive documentation is available in the docs directory, starting
-with README.md
+with [README.md](docs/README-android.md). If you are migrating from SDL 3.0
+from SDL 2.0, the changes are extensively documented in [README-migration.md](docs/README-migration.md).
 
 Enjoy!