some readme fixes and examples