- Note that Homebrew Cask issues should be filed elsewhere.
- Make `brew`/homebrew-core issue differential in simpler language
- Tell people to fix all `brew doctor` issues
- Refer to the issue checklist and make it even more clear and prominent
  that we may close it out immediately if they don't use it.
- Note that proposed new issues should be widely relevant.
- Don't tell people they need to `brew cask install java`; we handle
  this in most places with a Java requirement and probably want issues
  filed where we don't.
- Remove reference to Homebrew Dupes and replace with reference to
  Homebrew Cask to try and get people filing stuff there instead.

Fixes #2608

Also refactor audit cops into two "departments"
 - FormulaAudit
 - FormulaAuditStrict

Import new brew.sh CSS changes to improve the appearance of tables and
links.

GitHub provides a description and homepage field so let `brew create`
use them where possible. Also, detect GitHub repositories based on
`releases` as well as `archive`s.

Add `--only` and `--except` methods which can be used to selectively
enable or disable audit groups.

- Remove taps that are (or will shortly be) deprecated.
- Remove commands that are only relevant to the boneyard (which will
  shortly be removed).

Add labeled fences to most code blocks, monospace terms where
appropriate, omit "$" when referring to variables

Also works around bug in Jekyll where a URL with a "#" will cause links
in the same paragraph to not have their extensions replaced by using
"#" instead.

This is useful when you're pulling PRs where individual bottles can't be
uploaded/built but you still want to pull the PR as a whole anyway.

The existing `brew.1.html` wasn't particularly pleasant to read and
given everything else in `docs/` is a Markdown file it makes sense to
generate a post-processed Markdown file that can in turn be used by
Jekyll to generate a nicely themed HTML file.

Note some additional ways to help, gotchas and how to get started.

Also changes some heading levels so only one primary
heading appears per page.

While GitHub allows a single space to denote a sublist, Jekyll is not
so lenient. It also seems unable to handle ordered sublists.

Unfortunately there's no easy way to share this code with the brew.sh
site but it's at least able to have the `css/`, `img/` (root) and
`_layouts` directories in sync between the two repositories.

Some small CSS tweaks were needed to make these pages render more
attractively.

Closes #2186.

Also update command specifications to match descriptions.

Fixes to spelling and punctuation for consistency and readability.