updated README markdown and examples