added "how it works" and notes to readme