Add pointers to docs and build status in README.md

Also add examples/README.md