added some notes, links and code