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.

General Information