document new suite stanza

* includes other doc nits
* link to `sketchup.rb` will not work until the Casks are also changed
Merge pull request #6210 from rolandwalker/doc_suite_stanza

document new suite stanza