link to main README.md
focus on examples, improve usage notes