Developer doc tidying 2 rebased

Remaining nitpicks from Seb on #239
PR #243 rebased onto develop