GitHub now nicely generates a documentation site for us at http://brew.sh/brew based on our docs folder. Optimise the output of this and the GitHub docs directory for readability and the various user groupings.
This document was out of date as of https://github.com/Homebrew/brew/pull/1451