more examples and some wording improvements in the README