[PHPDoc] Links BeforeEvent & AfterEvent to SF's Event

[adriendupuis]

🎫 Issue	IBX-XXXXX

As this is outside the actual PHP API Ref Ibexa\Contracts scope, Symfony\Contracts\EventDispatcher\Event isn't documented. Those @link tags can help.

Renders as follow:

For comparison: https://doc.ibexa.co/en/master/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Event-BeforeEvent.html

Description:

For QA:

Documentation:

[sonarcloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarCloud

[alongosz]

@adriendupuis I've released code style 1.2.1. You can rebase this one against the latest 4.6 changes to also have unrelated PHPStan issues fixed.

[adamwojs]

@adriendupuis Could you please address issues reported by CI?

[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 SonarCloud

[adriendupuis]

Maybe it would be nicer to have it inline in the description.

Suggested change

	* @link https://github.com/symfony/symfony/blob/5.4/src/Symfony/Contracts/EventDispatcher/Event.php Symfony\Contracts\EventDispatcher\Event
	* It extends {@link https://github.com/symfony/symfony/blob/5.4/src/Symfony/Contracts/EventDispatcher/Event.php Symfony\Contracts\EventDispatcher\Event}.

[adriendupuis]

I have an inheritance issue to fix.

For example, https://doc.ibexa.co/en/master/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Events-Bookmark-CreateBookmarkEvent.html inherit the "Event emitted after action execution." description from AfterEvent. Only AfterEvent must be linked to its Symfony parent, not all its descendants.

[adriendupuis]

Will be done on PHP API Ref templating side: ibexa/documentation-developer#2547