Improved examples with tests to match and clarifications in README