This website uses Cookies. Click Accept to agree to our website's cookie use as described in our Privacy Policy. Click Preferences to customize your cookie settings.
Accept
Reject
Preferences
Log in to ask a question
Get hands-on experience with 20+ free Google Cloud products and $300 in free credit for new customers.
Log in to ask a question

API specification versioning against API releases,How is API specification versioning best done?

Posted on 08-11-2016 10:09 AM
Not applicable
Reply posted on --/--/---- --:-- AM

@Dom Couldwell has provided a great best practice page that specifically mentions using collaborative environments for specifying APIs. I am wondering how we manage multiple API releases against specification versions. For example, as I plan to add new features to a given API, I will update the spec (in Confluence in our case). At the same time others might be developing an older API release, but the spec has now been updated. Our specs spans several Confluence pages, so I'm wondering if there's a best practice / simple way for spec'ing APIs and relating them to specific API releases.

Thanks

1 1 539
Topic Labels
1 REPLY 1
Top Solution Authors
View all