updated README, added documentation and updated Cakefile accordingly