rose documentation: fixes/enhancements for suite tutorials

This adds a few fixes and enhancements that came from a quick run through the
suite tutorials. Affected files have also been `tidy`-ed.

@matthewrmshin, please review.
it was only in quotes really for purpose of referring to the above entry. You should probably put in in var tags instead