v2 transition/upgrade guide?

Is there documentation on transitioning to v2?

Or should my v1 plays “just work” in v2?

I ask because many of my v1 playbooks are not working when using the latest git pull but work fine when I “source v1/hacking/env-setup”

It should 'just work', we are aware of a few bugs but please report
yours as this is what we need to fix the current devel to make sure we
can release it.