added comments and documentation
added some context in the readme as well as some interesting bits about the code