homebrew_owner now tries to run homebrew as the user who owns the `brew` executable, or an optional homebrew_package resource attribute
Providing documentation for end-users, updating code with PR comment
Missed file on last commit
Fixing documentation errors
Moving documentation to a more logical place.  Also no longer dis-allowing users from running brew as root.
Fixing test
Merge pull request #2102 from opscode/tball/homebrew-owner

`brew` command now ran as user owning executable