[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:  Awaiting Review
Component:  Taxonomy      |    Version:  trunk
 Severity:  normal        |   Keywords:
  Focuses:                |
--------------------------+-----------------------------
 I first noticed a spelling mistake.

 taxonmies should be taxonomies.


 Then I found a few more things to comment on...

 In the sentence

 The function will accept an array (third optional parameter), along with
 strings for the taxonomy name and another string for the object type.

 This suggests that there could be multiple strings for the taxonomy name.
 Perhaps it's wise to remove 'and another string'.

 Or delete the whole sentence.

 Other questions

 - Is it a taxonomy name, taxonomy key or slug?
 - Is it object type or types?
 - Can you really pass "label"?
 See $args['label'] = $args['labels']->name;

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