[Serializer] Deprecate AdvancedNameConverterInterface

[mdoutreluingne]

Fix #20266

Here, I don't know if I should modify or delete the .. note:: block, what do you think?

[mtarld]

IMO yes, you should delete that note block.
And I think you should update the OrgPrefixNameConverter example as well

[mdoutreluingne]

I've also deleted the deprecated block that I'd added because AdvancedNameConverterInterface no longer refers to it in the documentation, so I don't think it's relevant to leave it.

Why do I need to update the example OrgPrefixNameConverter? AdvancedNameConverterInterface does not refer in this example

I may have not understood the changes that could occur with your PR, could you explain?

[mtarld]

It is because the NameConverterInterface signature has changed as well and triggers deprecations if not updated:

    public function normalize(string $propertyName/* , ?string $class = null, ?string $format = null, array $context = [] */): string;

It now must be used as the AdvancedNameConverterInterface was (same for the denormalization)

[mdoutreluingne]

Thank you for taking the time to explain

I've updated the OrgPrefixNameConverter example. do you approve?

[mtarld]

LGTM! Thanks @mdoutreluingne 🙂