[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