Developer doc tidying 2

Remaining nitpicks from Seb on #239