updated notes and readme.md for github