updated readme with examples and details