rose documentation: implement more feedback and bug fixes

@arjclark, please review.