[wp-trac] [WordPress Trac] #27098: Twenty Fourteen: Ditch all uses of `@return void`.

[WordPress Trac]

#27098: Twenty Fourteen: Ditch all uses of `@return void`.
-------------------------------+-----------------------------
 Reporter:  philiparthurmoore  |      Owner:
     Type:  defect (bug)       |     Status:  new
 Priority:  normal             |  Milestone:  Awaiting Review
Component:  Bundled Theme      |    Version:  trunk
 Severity:  normal             |   Keywords:
  Focuses:  docs               |
-------------------------------+-----------------------------
 It appears that the use of `@return void` should not be used for method or
 function !DocBlocks:

 - http://stackoverflow.com/a/2061559 (See: "The datatype should be a valid
 PHP type (int, string, bool, etc), a class name for the type of object
 returned, or simply "mixed"."
 - http://en.wikipedia.org/wiki/PHPDoc (See: "This tag should not be used
 for constructors or methods defined with a void return type.")

 What are your thoughts about removing this altogether?

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