rose documentation: implement feedback

This implements some feedback from the last training course.

@arjclark, please review.