TYPO3-Documentation / TYPO3CMS-Reference-CoreApi

"TYPO3 Explained": Main TYPO3 Core Document: Main classes, Security, TypoScript syntax, Extension API and much more
https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/
22 stars 393 forks source link

Missleading examples on Extbase ObjectStorage #3887

Open DanielSiepmann opened 9 months ago

DanielSiepmann commented 9 months ago

Current behavior

The documentation at https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ExtensionArchitecture/Extbase/Reference/Domain/Model.html is a bit misleading: The following sections all contain relations via ObjectStorage but without proper type annotation of the foreign model class. Developers only reading that part might get the feeling (see cms support channel in Slakc) that the annotation is no longer necessary:

Expected behavior/output

The code examples should be working code with a proper example model annotation.

Links

TYPO3 versions

12

Possible Solution

Extend the code example

Additional context

Add any other context or screenshots about your proposal here.

linawolf commented 6 months ago

Thanks for reporting this @DanielSiepmann. Could you imagine improvint the examples?