Cleanup root documentation.

4 files changed, 34 insertions, 63 deletions

diff --git a/CODEOFCONDUCT.md b/CODEOFCONDUCT.md
index f89b3fd07..d295aa56c 100644
--- a/CODEOFCONDUCT.md
+++ b/CODEOFCONDUCT.md
@@ -19,7 +19,7 @@ The Homebrew community welcomes and encourages participation by everyone. Our co
 
 We have created this diversity statement because we believe that a diverse Homebrew community is stronger and more vibrant. A diverse community where people treat each other with respect has more potential contributors and more sources for ideas.
 
-Although we have phrased the formal diversity statement generically to make it all-inclusive, we recognize that there are specific attributes that are used to discriminate against people. In alphabetical order, some of these attributes include (but are not limited to): age, culture, ethnicity, gender identity or expression, national origin, physical or mental difference, politics, race, religion, sex, sexual orientation, socio-economic status, and subculture. We welcome people regardless of the values of these or other attributes.
+Although we have phrased the formal diversity statement generically to make it all-inclusive, we recognise that there are specific attributes that are used to discriminate against people. In alphabetical order, some of these attributes include (but are not limited to): age, culture, ethnicity, gender identity or expression, national origin, physical or mental difference, politics, race, religion, sex, sexual orientation, socio-economic status, and subculture. We welcome people regardless of the values of these or other attributes.
 
 # Attribution
 This code of conduct is heavily based on the [Python Community Code of Conduct](http://www.python.org/psf/codeofconduct/) and the [Python Diversity Statement](http://www.python.org/community/diversity/).
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index eb0c59da5..6db42a677 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,26 +1,21 @@
-Contributing to Homebrew
-========================
-
-Reporting Bugs
---------------
+# Contributing to Homebrew
+## Reporting Bugs
 First, please run `brew update` and `brew doctor`.
 
-Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Troubleshooting.md).
+Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Troubleshooting.md#troubleshooting).
 
 **If you don't read these it will take us far longer to help you with your problem.**
 
-Security
---------
+## Security
 Please report security issues to security@brew.sh.
 
-Contributing
-------------
+## Contributing
 Please read:
 
-* [Code of Conduct](https://github.com/Homebrew/homebrew/blob/master/CODEOFCONDUCT.md)
-* [Formula Cookbook](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Formula-Cookbook.md)
-* [Acceptable Formulae](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Acceptable-Formulae.md)
+* [Code of Conduct](https://github.com/Homebrew/homebrew/blob/master/CODEOFCONDUCT.md#code-of-conduct)
+* [Formula Cookbook](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Formula-Cookbook.md#formula-cookbook)
+* [Acceptable Formulae](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Acceptable-Formulae.md#acceptable-formulae)
 * [Ruby Style Guide](https://github.com/styleguide/ruby)
-* [How To Open a Homebrew Pull Request (and get it merged)](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/How-To-Open-a-Homebrew-Pull-Request-(and-get-it-merged).md)
+* [How To Open a Homebrew Pull Request (and get it merged)](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/How-To-Open-a-Homebrew-Pull-Request-(and-get-it-merged).md#how-to-open-a-homebrew-pull-request-and-get-it-merged)
 
 Thanks!
diff --git a/README.md b/README.md
index 6e3dca3b7..7e88851e0 100644
--- a/README.md
+++ b/README.md
@@ -1,57 +1,34 @@
-Homebrew
-========
-Features, usage and installation instructions are [summarized on the homepage][home].
+# Homebrew
+Features, usage and installation instructions are [summarised on the homepage](http://brew.sh).
 
-What Packages Are Available?
-----------------------------
-1. You can [browse the Formula directory on GitHub][formula].
+## What Packages Are Available?
+1. You can [browse the Formula directory on GitHub](https://github.com/Homebrew/homebrew/tree/master/Library/Formula/).
 2. Or type `brew search` for a list.
-3. Or visit [braumeister.org][braumeister] to browse packages online.
-4. Or use [`brew desc`][brew-desc] to browse packages from the command line.
+3. Or visit [braumeister.org](http://braumeister.org) to browse packages online.
+4. Or use [`brew desc`](https://github.com/telemachus/homebrew-desc) to browse packages from the command line.
 
-More Documentation
-------------------
-`brew help` or `man brew` or check our [documentation][].
+## More Documentation
+`brew help` or `man brew` or check our [documentation](https://github.com/Homebrew/homebrew/tree/master/share/doc/homebrew#readme).
 
-Troubleshooting
----------------
+## Troubleshooting
 First, please run `brew update` and `brew doctor`.
 
-Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Troubleshooting.md).
+Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Troubleshooting.md#troubleshooting).
 
 **If you don't read these it will take us far longer to help you with your problem.**
 
-Security
---------
+## Security
 Please report security issues to security@brew.sh.
 
-Who Are You?
-------------
-Homebrew's current maintainers are [Misty De Meo][mistydemeo], [Adam Vandenberg][adamv], [Jack Nagel][jacknagel], [Mike McQuaid][mikemcquaid], [Brett Koonce][asparagui] and [Tim Smith][tdsmith].
-
-Homebrew was originally created by [Max Howell][mxcl].
-
-License
--------
-Code is under the [BSD 2 Clause (NetBSD) license][license].
-
-Donations
----------
-We accept tips through [Gittip][tip].
-
-[![Gittip](https://img.shields.io/gittip/Homebrew.svg?style=flat)](https://www.gittip.com/Homebrew/)
-
-[home]:http://brew.sh
-[documentation]:https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/
-[mistydemeo]:https://github.com/mistydemeo
-[adamv]:https://github.com/adamv
-[jacknagel]:https://github.com/jacknagel
-[mikemcquaid]:https://github.com/mikemcquaid
-[asparagui]:https://github.com/asparagui
-[tdsmith]:https://github.com/tdsmith
-[mxcl]:https://github.com/mxcl
-[formula]:https://github.com/Homebrew/homebrew/tree/master/Library/Formula/
-[braumeister]:http://braumeister.org
-[brew-desc]: https://github.com/telemachus/homebrew-desc
-[license]:https://github.com/Homebrew/homebrew/tree/master/LICENSE.txt
-[tip]:https://www.gittip.com/Homebrew/
+## Who Are You?
+Homebrew's current maintainers are [Misty De Meo](https://github.com/mistydemeo), [Adam Vandenberg](https://github.com/adamv), [Jack Nagel](https://github.com/jacknagel), [Mike McQuaid](https://github.com/mikemcquaid), [Brett Koonce](https://github.com/asparagui) and [Tim Smith](https://github.com/tdsmith).
+
+Homebrew was originally created by [Max Howell](https://github.com/mxcl).
+
+## License
+Code is under the [BSD 2 Clause (NetBSD) license](https://github.com/Homebrew/homebrew/tree/master/LICENSE.txt).
+
+## Donations
+We accept tips through [Gratipay](https://gratipay.com/Homebrew/).
+
+[![Gratipay](https://img.shields.io/gratipay/Homebrew.svg?style=flat)](https://www.gittip.com/Homebrew/)
diff --git a/SUPPORTERS.md b/SUPPORTERS.md
index 4ce4e2572..f189bbf4e 100644
--- a/SUPPORTERS.md
+++ b/SUPPORTERS.md
@@ -1,5 +1,4 @@
 # Kickstarter Supporters
-
 This file contains a list of the awesome people who gave £5 or more to
 [our Kickstarter](http://www.kickstarter.com/projects/homebrew/brew-test-bot).
 
@@ -8,7 +7,7 @@ a physical reward. Kickstarter recommends asking only when we are ready to
 ship (to avoid changes of address) so we can't ask for more names/URLs
 until then.
 
-These mindblowing people supported our Kickstarter by giving us £450 or more:
+These mind-blowing people supported our Kickstarter by giving us £450 or more:
 
 [![Hashrocket](https://s3.amazonaws.com/hashrocket-misc/hr_180x50.png)](http://hashrocket.com/)