[buddypress-trac] [BuddyPress Trac] #6576: @since standard not parseable with phpDocumentor 2

[buddypress-trac]

#6576: @since standard not parseable with phpDocumentor 2
---------------------------------+------------------
 Reporter:  DJPaul               |       Owner:
     Type:  defect (bug)         |      Status:  new
 Priority:  normal               |   Milestone:  2.4
Component:  Component - Any/All  |     Version:
 Severity:  normal               |  Resolution:
 Keywords:  dev-feedback         |
---------------------------------+------------------

Comment (by netweb):

 Related: #WP31340

 Quoting DrewAPicture

 > I would encourage you to use or not use `@subpackage` tags at your
 discretion.
 >
 > Part of the issue we have in core is that our parser currently only
 supports phpDocumentor 1.0 in which name-spaced `@package` tags are not
 supported and `@subpackage` tags are not deprecated. Thus the note in the
 WordPress documentation standards.
 >
 > When we opted to write our standard, we heavily leaned toward historical
 precedence of the code base, and that's something that we've maintained
 through today. The benefit of approaching change in this way is that
 later, when the PSR-5 recommendations are finalized and approved, it will
 be that much simpler for us to adjust to those new recommendations.

--
Ticket URL: <https://buddypress.trac.wordpress.org/ticket/6576#comment:17>
BuddyPress Trac <http://buddypress.org/>
BuddyPress Trac