[wp-trac] [WordPress Trac] #41927: Twenty Seventeen: Missing @return in comment documentation

WordPress Trac noreply at wordpress.org
Wed Sep 20 14:04:56 UTC 2017


#41927: Twenty Seventeen: Missing @return in comment documentation
---------------------------+------------------------------
 Reporter:  ndoublehwp     |       Owner:
     Type:  defect (bug)   |      Status:  new
 Priority:  normal         |   Milestone:  Awaiting Review
Component:  Bundled Theme  |     Version:  trunk
 Severity:  normal         |  Resolution:
 Keywords:  has-patch      |     Focuses:  docs
---------------------------+------------------------------

Comment (by xkon):

 @truongwp, usually we state what `returns` though. So shouldn't it
 actually be `@return Settings` or something similar on this instance?

 Ref: https://make.wordpress.org/core/handbook/best-practices/inline-
 documentation-standards/php/#1-functions-class-methods

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


More information about the wp-trac mailing list