rose documentation: update following feedback

This implements some recent feedback.

@arjclark, please review.