Thank you @atailouloute.

Adding the package and version before the message makes it much harder for the ecosystem to support both options-resolver 5.1+ and options-resolver 5.0-, as they would need to detect which signature to use when configuring their options (and I'm not even sure there is an easy and performant way to do that detection, which is important as the OptionsResolver is in the hot path of complex forms IIRC).

I think @stof is making a valid point and making the signature setDeprecated($message, $package = '', $version = '') makes it much easier to support both versions.

The point is, package and version should not be optional, we really want them to be required.

Keeping $message as the first argument would still help though as PHP would ignore additional arguments for OptionsResolver < 5.1 (we could allow it to be null to opt-in for reusing the default message template).