[wp-trac] [WordPress Trac] #59619: Remove discouraged `@return void` annotations

WordPress Trac noreply at wordpress.org
Thu Nov 16 11:47:33 UTC 2023


#59619: Remove discouraged `@return void` annotations
--------------------------+-----------------------
 Reporter:  flixos90      |       Owner:  flixos90
     Type:  defect (bug)  |      Status:  closed
 Priority:  normal        |   Milestone:  6.4
Component:  General       |     Version:
 Severity:  normal        |  Resolution:  fixed
 Keywords:  has-patch     |     Focuses:  docs
--------------------------+-----------------------

Comment (by afercia):

 Just noticed that [56943] mentions three exceptions:
 - bundled themes
 - third-party libraries
 - PHP compatibility shims.

 That makes sense, but the documentation linked in this issue
 [https://developer.wordpress.org/coding-standards/inline-documentation-
 standards/php/#:~:text=Note%3A%20%40return%20void%20should%20not%20be%20used%20outside%20of%20the%20default%20bundled%20themes
 only mentions bundled themes].

 I guess it's worth considering updating the documentation page
 accordingly?

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


More information about the wp-trac mailing list