Enhance @deprecated usage

[adriendupuis]

🎫 Issue	IBX-XXXXX

Related PRs:

ibexa/admin-ui#1398
ibexa/product-catalog#1205
ibexa/segmentation#109
ibexa/storefront#175

Description:

In @deprecated tags, add links to alternative elements to help navigate in PHP API Ref for future migration to 5.0.

Enhanceable entries were quickly found thanks to the hidden report https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/reports/deprecated.html

Previews:

• vendor/ibexa/admin-ui/src/contracts/UniversalDiscovery/Provider.php reworded without the redondant self-reference which had a missing backslash.
• vendor/ibexa/core/src/contracts/FieldType/BinaryBase/PathGenerator.php
• vendor/ibexa/core/src/contracts/IO/BinaryFile.php update the suggestions (still, they're outside the Contracts namespace so haven't any links).
• vendor/ibexa/core/src/contracts/Persistence/Content/ContentInfo.php
• vendor/ibexa/core/src/contracts/Persistence/Content/Handler.php
• vendor/ibexa/product-catalog/src/contracts/Values/AttributeDefinition/AttributeDefinitionQuery.php
• vendor/ibexa/product-catalog/src/contracts/Values/Price/Delete/Struct/ProductPriceDeleteStruct.php
• vendor/ibexa/product-catalog/src/contracts/Values/Price/Delete/Struct/ProductPriceDeleteStructInterface.php
• vendor/ibexa/product-catalog/src/contracts/Values/Price/Update/Struct/ProductPriceUpdateStruct.php
• vendor/ibexa/product-catalog/src/contracts/Values/Price/Update/Struct/ProductPriceUpdateStructInterface.php
• vendor/ibexa/segmentation/src/contracts/SegmentationServiceInterface.php
• vendor/ibexa/storefront/src/contracts/Repository/TaxonomyTreeServiceInterface.php reworded without self-reference.

For QA:

Documentation:

[sonarcloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud