fixes and add examples in README