update to README and examples