[TYPO3-core] Get rid of @package and @subpackage annotations
Oliver Hader
oliver.hader at typo3.org
Wed Oct 31 08:56:24 CET 2012
Hi Christian,
+1 I'm all for removing those lines
I happens that they are just wrong and don't follow any specified rules.
Having something like "@package TYPO3" does not really help either... ;-)
Concerning the @author annotations, I'd also like to have them removed.
Those only give an information about the initial author of a class or
method - if things are changed and rearranged, it also does not help
much. As Robert mentioned already "we have git blame for that"...
Cheers,
Olly
Am 29.10.12 16:37, schrieb Christian Kuhn:
> Hey there,
>
> we have those @package and @subpackage annotations in many core classes,
> but:
> * They are old and unmaintained (especially after namespace switch)
> * There is no rule set anywhere on what they should contain
> * They are used exactly ... well ... nowhere! Not even on API
> documentations like http://typo3.org/api/typo3/
> * The file location shows very well to which part a piece of code belongs.
>
> I propose to remove all of them without any substitution.
>
> Opinions?
>
>
> Regards
> Christian
--
Oliver Hader
TYPO3 CMS Core Team Leader
TYPO3 .... inspiring people to share!
Get involved: http://typo3.org
More information about the TYPO3-team-core
mailing list