In the run-up to 1.0, some of the early docs either a) changed due to refactor, or b) are out-of-date with current style/content decisions made in the more recent docs.

Need to go through existing SRML docs and update these two things.