Improve documentation for wp_count_terms()

[swissspidy]

wp_count_terms() takes an optional $args param that is passed to get_terms. Although that function is referenced in the docblock, it should probably use a proper @see reference. Duplicating the whole hash notation for $args probably doesn't make sense, though there's a @todo comment about it.

See the ​PHP documentation standards for more details.

[bordoni]

PHP Code Std + Docblock changes

[swissspidy]

Hi @bordoni, thanks for your patch!

Please note that code refactoring (even just adding spaces) shouldn't be done for the sake of refactoring. See ​https://make.wordpress.org/core/2011/03/23/code-refactoring/ for details. We're concentrating on the docblock here.

Besides that, Version is used to indicate the WordPress version this bug was first introduced and the good-first-bug keyword should remain. Instead, I'll set you as an owner here, marking this good-first-bug as claimed.

[swissspidy]

34861.diff​ is an updated patch without the coding standards changes; also removing the @todo from the DocBlock.

[SergeyBiryukov]

In 35895:

Docs: Improve documentation for wp_count_terms().

Props bordoni, swissspidy.
Fixes #34861.