diff --git a/docs/api/index.md b/docs/api/readme.md
similarity index 100%
rename from docs/api/index.md
rename to docs/api/readme.md
diff --git a/docs/intro/index.md b/docs/intro/readme.md
similarity index 100%
rename from docs/intro/index.md
rename to docs/intro/readme.md
diff --git a/docs/index.md b/docs/readme.md
similarity index 67%
rename from docs/index.md
rename to docs/readme.md
index c459849f..3bb3799b 100644
--- a/docs/index.md
+++ b/docs/readme.md
@@ -6,8 +6,8 @@ Cachet is an open source alternative to StatusPage.io written in PHP 5 with the
 
 ### Introduction
 
-- [Introduction to Cachet](/docs/intro/index.md)
+- [Introduction to Cachet](/docs/intro/readme.md)
 
 ### API
 
-- [Cachet API](/docs/api/index.md)
+- [Cachet API](/docs/api/readme.md)