fixed markup

Closes #468
Axe useless docs, compress others onto one page
Add (more) contribution guidelines
use pyflakes in travis-ci and add makefile
Remove more "documentation"
more lint
travis: run both lint and tests
better instructions on how to run tests