Appendices¶
Appendices contain information regarding the new features introduced in each version and the migration path between versions.
4.x Migration Guide¶
Backwards Compatibility Shimming¶
If you need/want to shim 3.x behavior, or partially migrate in steps, check out the Shim plugin that can help mitigate some BC breaking changes.
Forwards Compatibility Shimming¶
Forwards compatibility shimming can prepare your 3.x app for the next major release (4.x).
If you already want to shim 4.x behavior into 3.x, check out the Shim plugin. This plugin aims to mitigate some backwards compatibility breakage and help backport features from 4.x to 3.x. The closer your 3.x app is to 4.x, the smaller will be the diff of changes, and the smoother will be the final upgrade.