ran autopep8 to make the code, er, somewhat readable.
DOC: more explicit instructions for installation and re-building the doc.