Tidy up

Break up walls of text into small sections. Bring old docs up to speed with newer ones.
Fix typo
Add API docs explaining how to get list of projects user has access to