Some user accessible points in this software package should be considered "alpha". This means that the developer team is not investing _any_ effort to provide backward compatibility between alpha releases for these parts. This software will continue to be released as "alpha" until its code, schemas, and APIs are considered stable.
Until then, there will be no warranty that newer versions will maintain backward compatibility for such parts, even in the most simple cases. However, once "beta" status is reached, backward incompatible changes will be made only when absolutely necessary to reach "final" status.
The Cocoon development team understands the importance of reliable software as well protecting user investments through the creation of a solid development platform that doesn't change. On the other hand, Cocoon 3 should give its developers the freedom to experiment and to react quickly on feedback. Thus, reliability cannot be guaranteed before the software achieves its "final" status.
Until then, no effort will be provided to guarantee backward compatibility for any parts considered alpha.
You have been warned.