diff --git a/README.md b/README.md
index b5112f87e1c3a9654821b0f0e7ccd88d83827216..1d5abba520770d916882666ba97fba47f112a107 100644
--- a/README.md
+++ b/README.md
@@ -11,13 +11,17 @@ Documentation
 -------------
 
 
-[Installation instructions](https://git.fmrib.ox.ac.uk/paulmc/fslpy/wikis/home)
+Check out the [Installation instructions](https://git.fmrib.ox.ac.uk/paulmc/fslpy/wikis/home)
+for details on getting started.
 
-[Documentation for users](http://users.fmrib.ox.ac.uk/~paulmc/fslpy_doc/index.html)
 
-[Documentation for developers](http://users.fmrib.ox.ac.uk/~paulmc/fslpy_apidoc/index.html)
+The [Documentation for users](http://users.fmrib.ox.ac.uk/~paulmc/fslpy_doc/index.html)
+provides a comprehensive overview of how to use *FSLeyes*.
 
 
+Take a look at the [Documentation for developers](http://users.fmrib.ox.ac.uk/~paulmc/fslpy_apidoc/index.html)
+if you want to program with `fslpy`.
+
 
 Dependencies
 ------------