[wp-trac] [WordPress Trac] #34751: Improve the readability of the default arguments of the wp_list_categories()

[WordPress Trac]

#34751: Improve the readability of the default arguments of the
wp_list_categories()
------------------------------+------------------
 Reporter:  birgire           |       Owner:
     Type:  enhancement       |      Status:  new
 Priority:  normal            |   Milestone:  4.5
Component:  Taxonomy          |     Version:  4.4
 Severity:  normal            |  Resolution:
 Keywords:  has-patch commit  |     Focuses:
------------------------------+------------------

Comment (by swissspidy):

 Replying to [comment:4 birgire]:
 > ps: there are tons of similar adjustments possible in the core.
 >
 > I could add the patches under this current ticket (I guess we would need
 to change the title?) or I could just create another ticket to combine
 them all?

 I totally believe that there are tons of similar "bugs" in the code base.
 If you find any other areas where it definitely makes sense to improve
 readability / documentation, feel free to open another ticket.

 Just note that we don't refactor just for the sake of refactoring:
 https://make.wordpress.org/core/2011/03/23/code-refactoring/.

 `wp_list_categories()` stands out because there are lots of arguments
 which are hard to read and not all of them are properly documented in the
 function's DocBlock (see [35140]).

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