[wp-trac] [WordPress Trac] #31340: Use of the @subpackage tag in documentation

[WordPress Trac]

#31340: Use of the @subpackage tag in documentation
--------------------------+-----------------------------
 Reporter:  henry.wright  |      Owner:
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  General       |    Version:
 Severity:  normal        |   Keywords:
  Focuses:  docs          |
--------------------------+-----------------------------
 The documentation standards [https://make.wordpress.org/core/handbook
 /inline-documentation-standards/php-documentation-standards/#6-file-
 headers mention] that the @subpackage tag should be used in all file
 header DocBlocks but the phpDocumentor docs consider the tag deprecated.
 See
 [http://www.phpdoc.org/docs/latest/references/phpdoc/tags/subpackage.html
 here].

 Should I continue to use @subpackage when documenting plugins?

--
Ticket URL: <https://core.trac.wordpress.org/ticket/31340>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform