updated README file and documentation

Benjamin Mako Hill || Want to submit a patch?