read me updated with examples