Update README.md

Add clojure API examples taken from the unit tests.
Beef-up the introductory section.