rose documentation: implement more feedback

This updates the documentation based on some recent feedback.

@matthewrmshin, please review.