final, review notes
added links to readme