[wp-trac] [WordPress Trac] #27098: Bundled Themes: ditch all uses of `@return void`

[WordPress Trac]

#27098: Bundled Themes: ditch all uses of `@return void`
-------------------------------+---------------------
 Reporter:  philiparthurmoore  |       Owner:
     Type:  defect (bug)       |      Status:  closed
 Priority:  normal             |   Milestone:  3.9
Component:  Bundled Theme      |     Version:  trunk
 Severity:  normal             |  Resolution:  fixed
 Keywords:  has-patch          |     Focuses:  docs
-------------------------------+---------------------

Comment (by DrewAPicture):

 Replying to [comment:23 GaryJ]:
 > The overridding factor here is historical precedent - while the rest of
 PHP might be using `@return void` (perhaps originating from those with a
 similar background as yours), WP was only doing so in limited
 circumstances and doing it inconsistently so the cleanest and semantically
 correct option was to not use it at all.

 Yep. And with that, I'm going to suggest that anyone interested continue
 this conversation at the weekly inline docs chat, held on Wednesdays at
 19:00 UTC in #wordpress-sfd. I'll be happy to add it to the agenda.

 We're also open to discussions on the make/docs P2 from interested
 community members.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/27098#comment:24>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform