a whole bunch of docs and fixes
Merge branch 'master' of github.com:metamx/druid