changed comments for clarity, added examples, todo and issues to readme