Backward compatibility: (v3.0)
1) Versioning & backward compatibility
Since version 2, the
pac4j project has adopted the semver versioning, to make things clearer.
Given a version X.Y.Z:
- when X changes, it’s a major version with breaking changes (example: 2.x, 3.x, and so on)
- when Y changes, it’s a minor version with no compilation/runtime breaking changes (for example, you can upgrade from 2.5.2 to 2.7.0 without any worry)
- when Z changes, it’s a bug fix(es) version with no compilation/runtime breaking change (no upgrade issue either).
Generally, pac4j implementations will adopt the semver versioning when upgrading to
pac4j version 2, if they don’t already have.
pac4j-*modules are backward compatible, you should always add the
pac4j-coredependency in the same version as the upgraded
Two stable and released streams of
pac4j are maintained at the same time.
During the development of the version 2, the streams: 1.8 and 1.9 are maintained.
After the release of the version 2, the streams: 1.9 and 2.x will be maintained.
After the release of the version 3, the streams: 2.x and 3.x will be maintained.
And so on.