rose documentation: implement feedback from training

This implements some feedback following a recent training course.

@matthewrmshin, please review.