diff --git a/README.md b/README.md
index 474a0563e809e05194c26611cd42ab9558bd906f..cc9a413b7722f38d961fdc0ccbc6a44fc91db53b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # gitlab-mirrors
 
-The [gitlab-mirrors](https://github.com/sag47/gitlab-mirrors) project is designed to fill in a feature which is currently missing from GitLab: the ability to mirror remote repositories.  gitlab-mirrors creates read only copies of remote repositories in gitlab.  It provides a CLI management interface for managing the mirrored repositories (e.g. add, delete, update) so that an admin may regularly update all mirrors using `crontab`.  It operates by interacting with the [GitLab API][1] using [python-gitlab][2].
+The [gitlab-mirrors](https://github.com/sag47/gitlab-mirrors) project is designed to fill in a feature which is currently [missing from GitLab](http://feedback.gitlab.com/forums/176466-general/suggestions/4286666-mirror-git-svn-into-repo-): the ability to mirror remote repositories.  gitlab-mirrors creates read only copies of remote repositories in gitlab.  It provides a CLI management interface for managing the mirrored repositories (e.g. add, delete, update) so that an admin may regularly update all mirrors using `crontab`.  It operates by interacting with the [GitLab API][1] using [python-gitlab][2].
 
 
 ## Features
@@ -57,34 +57,3 @@ Created by Sam Gleske under [MIT License](LICENSE).
 * Bzr support #6 [Agustín Cruz Lozano](https://github.com/agb80) (atin81@gmail.com)
 * SVN update tags #13 [Nikolaus Krismer](https://github.com/nikolauskrismer)
 
-
----
-## References
-
-This project is meant to temporarily fill in a gap left by GitLab for managing remote repository mirrors (namely git and svn).  See the following user voice topics which enabled me to create this project in the mean time.
-
-* [Mirror git/svn into repo.][3]
-* [Feature request -- Multi-Master mirroring][4]
-* [Git mirror][5]
-* [Git push all branches][6]
-* [Git update mirror][7]
-* [Splitting Subversion into Multiple Git Repositories][8]
-* [Git-svn Tutorial][9]
-* [Why git can't clone into a bare repository][10]
-* [How to convert a git repository from normal to bare][11]
-* [Converting CVS repositories to git][12]
-
-This project will still be useful after repository mirror support is native in GitLab because it allows admins to mirror massive amounts of repositories in an automated fashion.  When native mirror support is included this project will likely be refactored into a script to automate adding mirrors via the API.
-
-[1]: https://github.com/gitlabhq/gitlabhq/blob/master/doc/api/README.md
-[2]: https://github.com/sag47/python-gitlab
-[3]: http://feedback.gitlab.com/forums/176466-general/suggestions/4286666-mirror-git-svn-into-repo-
-[4]: http://feedback.gitlab.com/forums/176466-general/suggestions/3697598-feature-request-multi-master-mirroring
-[5]: http://stackoverflow.com/questions/2756747/mirror-a-git-repository-by-pulling
-[6]: http://stackoverflow.com/questions/1914579/set-up-git-to-pull-and-push-all-branches
-[7]: https://github.com/ndechesne/git-mirror/blob/master/git-mirror
-[8]: http://daneomatic.com/2010/11/01/svn-to-multiple-git-repos/
-[9]: http://trac.parrot.org/parrot/wiki/git-svn-tutorial
-[10]: http://stackoverflow.com/questions/12544318/why-git-svn-cannot-clone-a-bare-repo
-[11]: http://stackoverflow.com/questions/2199897/how-to-convert-a-git-repository-from-normal-to-bare
-[12]: http://stackoverflow.com/questions/7344941/converting-cvs-repositories-to-git
diff --git a/docs/references.md b/docs/references.md
new file mode 100644
index 0000000000000000000000000000000000000000..ae1e8a196876f70abcd4cb3584c61ba1c3f497ee
--- /dev/null
+++ b/docs/references.md
@@ -0,0 +1,31 @@
+---
+## References
+
+This project is meant to temporarily fill in a gap left by GitLab for managing remote repository mirrors (namely git and svn).  See the following user voice topics which enabled me to create this project in the mean time.
+
+* [Mirror git/svn into repo.][3]
+* [Feature request -- Multi-Master mirroring][4]
+* [Git mirror][5]
+* [Git push all branches][6]
+* [Git update mirror][7]
+* [Splitting Subversion into Multiple Git Repositories][8]
+* [Git-svn Tutorial][9]
+* [Why git can't clone into a bare repository][10]
+* [How to convert a git repository from normal to bare][11]
+* [Converting CVS repositories to git][12]
+
+This project will still be useful after repository mirror support is native in GitLab because it allows admins to mirror massive amounts of repositories in an automated fashion.  When native mirror support is included this project will likely be refactored into a script to automate adding mirrors via the API.
+
+[1]: https://github.com/gitlabhq/gitlabhq/blob/master/doc/api/README.md
+[2]: https://github.com/sag47/python-gitlab
+[3]: http://feedback.gitlab.com/forums/176466-general/suggestions/4286666-mirror-git-svn-into-repo-
+[4]: http://feedback.gitlab.com/forums/176466-general/suggestions/3697598-feature-request-multi-master-mirroring
+[5]: http://stackoverflow.com/questions/2756747/mirror-a-git-repository-by-pulling
+[6]: http://stackoverflow.com/questions/1914579/set-up-git-to-pull-and-push-all-branches
+[7]: https://github.com/ndechesne/git-mirror/blob/master/git-mirror
+[8]: http://daneomatic.com/2010/11/01/svn-to-multiple-git-repos/
+[9]: http://trac.parrot.org/parrot/wiki/git-svn-tutorial
+[10]: http://stackoverflow.com/questions/12544318/why-git-svn-cannot-clone-a-bare-repo
+[11]: http://stackoverflow.com/questions/2199897/how-to-convert-a-git-repository-from-normal-to-bare
+[12]: http://stackoverflow.com/questions/7344941/converting-cvs-repositories-to-git
+