feat(README): add an API versioning section

Based on a question on the mailing list. Add a section about API versioning.