Update README with examples and doc of the new API