feat(README): add an API versioning section

Based on a question on the mailing list. Add a section about API
versioning.
Merge pull request #421 from philips/README-api-versioning

feat(README): add an API versioning section