Final docs pass

This cleans up and reorganizes the docs based on the conversation @nathansobo and I had today. 

This is just docs changes. Mostly renaming sections, and moving methods between sections.