diff --git a/docs/README.md b/docs/README.md
index fe01fafc8..39dc8469e 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,12 +1,12 @@
 # gulp documentation
 
-* [Getting Started](getting-started.md) - How to get going with gulp
-* [API documentation](API.md) - Learn the ins and outs of using gulp
+* [Getting Started](getting-started.md) - Get started with gulp
+* [API documentation](API.md) - The programming interface, defined
 * [CLI documentation](CLI.md) - Learn how to call tasks and use compilers
-* [Writing a Plugin](writing-a-plugin/README.md) - So you're writing a gulp plugin? Go here for the essential dos and don'ts.
-* [Why Use Pump?](why-use-pump/README.md) - Why you should use the `pump` module instead of calling `.pipe` yourself.
-* [Simplified Chinese documentation][SimplifiedChineseDocs] - gulp 简体中文文档.
-* [Korean documentation][KoreanDocs] - gulp 한국어 참조 문서.
+* [Writing a Plugin](writing-a-plugin/) - The essentials of writing a gulp plugin
+* [Why Use Pump?](why-use-pump/README.md) - Why to use the `pump` module instead of calling `.pipe` yourself
+* [Simplified Chinese documentation][SimplifiedChineseDocs] - gulp 简体中文文档
+* [Korean documentation][KoreanDocs] - gulp 한국어 참조 문서
 
 
 ## FAQ
@@ -21,7 +21,7 @@ The community has written [recipes](recipes#recipes) for common gulp use-cases.
 
 ## Still got questions?
 
-Post on [StackOverflow with a #gulp tag](http://stackoverflow.com/questions/tagged/gulp), or come chat with us in [#gulpjs](http://webchat.freenode.net/?channels=gulpjs) on [Freenode](http://freenode.net/).
+Post on [StackOverflow with a #gulp tag](http://stackoverflow.com/questions/tagged/gulp) or come chat with us in [#gulpjs](http://webchat.freenode.net/?channels=gulpjs) on [Freenode](http://freenode.net/).
 
 
 ## Books