Igniters, We try to maintain API compatibility and keep default behavior unchanged between minor releases. But as product evolves, some APIs become deprecated, new best practices appear, and some defaults are changed.
We had a talk with Andrey Gura and he suggested to add *"Migration Guide"* to our release cycle. This is a document where we will list all important changes since the last version and our recommendations how to use them. If done properly this should speedup adoption of new features and migration to newer versions. Here are several examples from other vendors: 1) Hibernate - https://github.com/hibernate/hibernate-orm/wiki/Migration-Guide---5.2 2) Play - https://www.playframework.com/documentation/2.6.x/Migration26 I propose to start creating migration guides since the next release, Apache Ignite 2.6. For now let's decide whether community supports this idea, and if yes - how to publish it. I would propose to do it as follows: 1) Add MIGRATION_GUIDE document next to RELEASE_NOTES. This document should be updated by contributors during development. 2) After release: publish separate page next to release notes [1] 3) Add links to migration guide to download page [2] Please share your thoughts. Vladimir. [1] https://ignite.apache.org/releases/2.4.0/release_notes.html [2] https://ignite.apache.org/download.cgi