[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 tw2113):

 Replying to [comment:10 johnjamesjacoby]:
 > How about:
 >
 > * `@since 2.7.0 BuddyPress (rxxxx) - Whatever the details are` where the
 (rxxxx) is optional. We've debated the usefulness of including the
 changeset in the past, but I have a tendency to use them in bbPress quite
 a bit for looking back in time very easily without loading up annotations
 every time.
 > * `@package BuddyPress` at the top of each file in the PHPDoc block
 > * `@subpackage Functions` underneath `@package` where "Functions" is
 some descriptor that works across all components (Actions, Cache, Classes,
 Assets, Filters, Functions, Loader, Notifications, Screens, TemplateTags,
 Widgets, etc...)

 I am going to start looking into changing things based on these
 guidelines. I have some time off to start the week which would make for
 some good contribution time. We will do this for both function
 declarations and hooks.

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