diff --git a/README.md b/README.md
index 4993ce98..1b9f7549 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,13 @@ mcuboot works with both the Apache Mynewt, and Zephyr operating systems, but
 more ports are planned in the future. RIOT is currently supported as a boot
 target with a complete port planned.
 
+## Using MCUboot
+
+Instructions for different operating systems can be found here:
+- [Zephyr](docs/readme-zephyr.md)
+- [Mynewt](docs/readme-mynewt.md)
+- [RIOT](docs/readme-riot.md)
+
 ## Roadmap
 
 The issues being planned and worked on are tracked on Jira. To participate
diff --git a/docs/index.md b/docs/index.md
index 92524633..9be0edf2 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -19,7 +19,10 @@ target with a complete port planned.
 - [Release notes]({% link release-notes.md %})
 - [design]({% link design.md %}): for the design
 - [imgtool]({% link imgtool.md %}): The image signing and key management
-  tool.
+- Usage instructions:
+  - [Zephyr]({% link readme-zephyr.md %})
+  - [Mynewt]({% link readme-mynewt.md %})
+  - [RIOT]({% link readme-riot.md %})
 - [Patch submission]({% link SubmittingPatches.md %}) for information
   on how to contribute to mcuboot.
 - Testing