Improvements needed to docblock for register_taxonomy()

[bobbingwide]

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 $argslabel? = $argslabels?->name;

[bobbingwide]

Replying to bobbingwide:

$args['label'] = $args['labels']->name;

[boonebgorges]

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.

[boonebgorges]

In 38737:

Docs: Improvements to register_taxonomy() docblock.

• Fix spelling and whitespace.
• Remove $label argument documentation. This argument hasn't worked since [14614], despite the documentation added in [14619].

Props bobbingwide.
Fixes #38007.