rewrite README: add new API, add examples, remove low-level details