Big update to docs

I'll merge this once I have commit access.