updating docs

I'm updating the docs, fixing small things that have been removed (or added). 

this isn't ready to merge yet, just wanted to make a placeholder for it so there's no duplication of effort