Updated README with improved examples and explanation of design