[wp-trac] [WordPress Trac] #64211: Twenty Eleven: Improve PHP DocBlock compliance with WordPress Documentation Standards

[WordPress Trac]

#64211: Twenty Eleven: Improve PHP DocBlock compliance with WordPress Documentation
Standards
-----------------------------+--------------------------
 Reporter:  huzaifaalmesbah  |       Owner:  westonruter
     Type:  defect (bug)     |      Status:  reviewing
 Priority:  normal           |   Milestone:  7.0
Component:  Bundled Theme    |     Version:  3.2
 Severity:  normal           |  Resolution:
 Keywords:  has-patch        |     Focuses:  docs
-----------------------------+--------------------------

Comment (by westonruter):

 @ravichudasama01 For the `widget()` method: Core doesn't typically use
 `@return void`, except in third party libraries. The exception to this is
 when the function can return `void` '''or''' a non-`void` value, for
 example `do_enclose()` has `@return void|false`. I think core should
 update any such uses of `void` to return `null` instead, in any case.

 As for the `update` method, I see the phpdoc being added? See
 [https://github.com/WordPress/wordpress-develop/pull/10482/files#diff-
 f041c4fac4e50be5b7c3ee30f812a7dcf85424acb60d57e8a4c8a68adb14fefa file in
 PR].

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