[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