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.
`buy_cake` renamed to `purchase_cake` as I kept reading it as the `bake_cake` task