[wp-trac] [WordPress Trac] #27200: Remove all @package and @subpackage tags from function DocBlocks
WordPress Trac
noreply at wordpress.org
Tue Feb 25 14:47:22 UTC 2014
#27200: Remove all @package and @subpackage tags from function DocBlocks
--------------------------+------------------------------
Reporter: DrewAPicture | Owner:
Type: defect (bug) | Status: new
Priority: normal | Milestone: Awaiting Review
Component: General | Version:
Severity: normal | Resolution:
Keywords: has-patch | Focuses: docs
--------------------------+------------------------------
Comment (by Rarst):
A little more generic question is if `@package WordPress` even doing
anything anyone needs?
From PSR-5
> If, across the board, both logical and functional subdivisions are equal
is it NOT RECOMMENDED to use the @package tag, to prevent maintenance
overhead.
There are no real subdivisions or namespaces in WP, neither there are may
"packages" (couple bundled libs do come with them) and `@package
WordPress` is applied rather randomly and purposelessly.
I think on more general level possible actions are either standardizing
and enforcing how it's used or getting rid of it altogether.
--
Ticket URL: <https://core.trac.wordpress.org/ticket/27200#comment:5>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list