[wp-trac] [WordPress Trac] #28885: Inline Docs audit for 4.0

WordPress Trac noreply at wordpress.org
Tue Jul 15 16:24:23 UTC 2014


#28885: Inline Docs audit for 4.0
----------------------------+---------------------------
 Reporter:  DrewAPicture    |       Owner:  DrewAPicture
     Type:  task (blessed)  |      Status:  assigned
 Priority:  normal          |   Milestone:  4.0
Component:  General         |     Version:
 Severity:  normal          |  Resolution:
 Keywords:  has-patch       |     Focuses:  docs
----------------------------+---------------------------

Comment (by dnaber-de):

 While you're cleaning up the inline docs, you may want to have a look at
 the wrong parameter type specified for a custom Walker in
 wp_list_comments().


 {{{
  *     @type string 'walker'            The Walker class used to list
 comments. Default null.
 }}}
 `string` is wrong. A correct type definition would be `Walker_Comment`,
 but that is only the half of the truth. As long as there is no interface
 defined, the type should be `object` with the description of an
 implemented method `paged_walk()`.

 Is it possible to attach another diff-file to this ticket?

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


More information about the wp-trac mailing list