The changelog for 4.0 does not mention BC breaks

[stof]

Description

Based on the mentioned changes, I think that those BC breaks were done as part of the "Preparing 4.0.0" change, but this is not explanatory for readers of those release notes.
Mentioning the BC breaks of a major version is probably the most important part of release notes, as far as consumers of the project are concerned.

[stof]

From a quick look, it seems like the constructor signatures have changed for a bunch of classes (the ones dealing with a clock for instance), because of changing the order of arguments. This is quite important to know about it, and even https://web-token.spomky-labs.com/migration/from-v1.x-to-v2.0-2 does not mention it (it mentions that the clock is mandatory, but not the argument reordering).

As I now discovered this migration guide in the doc, I think linking to it from the release notes might be enough (if it is updated to be complete).
Side note: the URL of that migration guide from 3.x to 4.0 is quite weird.