Sysadmin docs tidy (rebased onto develop)



This is the same as gh-209 but rebased onto develop.

----

Fixing an issue spotted by Kenny and then tidying sysadmin docs re: formatting and style rules.
Also see ticket 10114