Updates README and examples for latest behaviour