[wp-trac] [WordPress Trac] #34861: Improve documentation for wp_count_terms()
WordPress Trac
noreply at wordpress.org
Sun Dec 6 16:18:05 UTC 2015
#34861: Improve documentation for wp_count_terms()
--------------------------+----------------------------------------
Reporter: swissspidy | Owner:
Type: defect (bug) | Status: new
Priority: normal | Milestone: Awaiting Review
Component: Taxonomy | Version:
Severity: normal | Keywords: needs-patch good-first-bug
Focuses: docs |
--------------------------+----------------------------------------
`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 [https://make.wordpress.org/core/handbook/best-practices/inline-
documentation-standards/php/#docblock-formatting PHP documentation
standards] for more details.
--
Ticket URL: <https://core.trac.wordpress.org/ticket/34861>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list