add: details and examples to readme