polishing the readme and examples