update/optimise docs
Merge branch 'master' of https://github.com/SimonHarte/responsibly