doc: tweaks to CONTRIBUTING.md

- subheads so we can link directly to CONTRIBUTING.md#cask-stanzas
- clarification on naming `pkg` Casks
- fix repetitive language
Merge pull request #3286 from rolandwalker/doc_contributing_tweaks

doc: tweaks to CONTRIBUTING.md