updated documentation after a readthrough

Benjamin Mako Hill || Want to submit a patch?