-
Re: Jive API versioning
nilsheuer May 6, 2013 1:43 PM (in response to nilsheuer)OK, this is getting annoying. Can someone from Jive provide some guidance here? (Mark Weitzel , Craig McClanahan)
Can you provide some cleaner versioning information here. I'm starting to see way too many "if (osapi.jive.corev3.something!=undefined) " in my code.
-
Re: Jive API versioning
craig.mcclanahanMay 6, 2013 2:15 PM (in response to nilsheuer)
1 person found this helpfulThe rules we've been following in Core V3 development have been as follows:
- It is OK to add new endpoints.
- It is OK to add new fields to existing entities.
- It is not OK to remove existing endpoints or entities.
- It is not OK to change the semantics of existing endpoints.
Basically stated, the goal is continuously backwards compatibility, with the addition of new features and capabilities over time. The name of the API (Jive Core API V3) does not change, because it is the same API.
Regarding @since, everything not marked has been available since the original release of Jive 6. The incrementing number after the decimal essentially identifies which cloud release this feature was made available in (3.3 is the recently released 2Q13 cloud update). The only time that identifier would be relevant if is if you are programming against a sandbox of brand new functionality. That will rarely be the case outside of Jive.
-