moved doc to readme.md

Besides a few minor tweaks to the code, this releases moves the documentation to Github by showing it in readme.md, instead of in a separate HTML file.