README updated with details and examples