rose documentation: update/fix user guide

This updates some of the Rose User Guide documentation where necessary.

@arjclark, please review.