add in notes about API
move everything to v2
Merge pull request #2581 from andymckay/api

add in notes about API versioning