rose documentation: changes following feedback
metomi/rose#950: changes following feedback