updated README and examples