PROPOSAL - general improvements

General changes, improvements and typo fixes.

- [x] @HelenRoss 
- [x] @antfrew 
- [x] kate
- [x] @joelr