updating docs

I'm updating the docs, fixing small things that have been removed (or added). 

this file is ready to merge