Backwards Compatibility Strategy

[dan1]

Hi,

I didn't find anything about backwards compatibility in neither the FAQ nor the user's guide. Is the strategy documented somewhere? I found a few posts that mentioned backwards compatibility. Here is the main one…

Activiti is stable as it gets. All API's defined since 5.0 are guaranteed not to change. If needed, we introduce backwards compatibility and deprecation strategies with clear documentation.

If an API were to marked as deprecated, how long would it continue to be supported? Is that measured in terms of years, or number of releases, or are such things decided on a case by case basis?

Thanks,
Dan

[jbarrez]

The general rule of thumb is that, when we deprecate something, we give it two releases before we remove it. And indeed, when we do it, we make sure there is a compatible way (note: this doesn't mean some small code changes would be needed) to achieve similar functionality.