Minor nitpicks from JM on recent docs PRs
Merge pull request #433 from hflynn/rebased/develop/minor_tidying

Minor tidying (rebased onto develop)