API Versioning

Let me first off say, thank you for doing this collaboratively and for all the work that has gone into this.

I do find the versioning section to be very prescriptive. Versioning is hard. Our project currently releases every day and usually has API changes on every release. Not breaking changes, but usually small additions. We're starting to get third-party consumers and will version when we introduce a breaking change.

I feel versioning at this fidelity forces an event driven architecture which is an unneeded complexity for many applications.

Feel free to hit me up in the lab if you'd like to discuss more.