[wp-trac] [WordPress Trac] #38007: Improvements needed to docblock for register_taxonomy()

[WordPress Trac]

#38007: Improvements needed to docblock for register_taxonomy()
--------------------------+------------------
 Reporter:  bobbingwide   |       Owner:
     Type:  defect (bug)  |      Status:  new
 Priority:  normal        |   Milestone:  4.7
Component:  Taxonomy      |     Version:  3.0
 Severity:  normal        |  Resolution:
 Keywords:                |     Focuses:
--------------------------+------------------
Changes (by boonebgorges):

 * version:  trunk => 3.0
 * milestone:  Awaiting Review => 4.7


Comment:

 Thanks for the spelling catch.

 The entire "A simple function..." paragraph looks superfluous to me. It
 probably dates from before we had `@param` docs. Let's cut it.

 > Can you really pass "label"?

 Hm. It appears that you cannot. The ability to pass 'label' was removed
 when the 'labels' array was introduced in [14614]. In [14619], the
 documentation was updated to say that 'label' could be passed again - a
 sort of revert - but the actual functionality was not restored. This part
 of the documentation has managed to survive a number of reworkings of the
 docblock.

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