API CHANGE: transitions are differenciated by property, and passed as a dict

Update README
Add docstring with example inside it