update README with new docs & updated code examples

Make README consistent with current state of compiler.

[ci skip]