first pass at new docs. moved a bunch of stuff out of the README and into docs/. @coryvirok