[wp-trac] [WordPress Trac] #19780: Named category functions/docs need cleaning up

[WordPress Trac]

#19780: Named category functions/docs need cleaning up
--------------------------+------------------------------
 Reporter:  DrewAPicture  |       Owner:
     Type:  enhancement   |      Status:  new
 Priority:  normal        |   Milestone:  Awaiting Review
Component:  Taxonomy      |     Version:
 Severity:  normal        |  Resolution:
 Keywords:                |
--------------------------+------------------------------
Description changed by helenyhou:

Old description:

> Spawning from a small discussion in #19766, I think it's about time
> something is done to deal with the older named category functions such as
> `wp_category_dropdown` and `wp_list_categories` in category-template.php
>
> These functions aren't technically category-only as they accept a set
> $taxonomy. And because they are actually taxonomy-agnostic, I think we
> have a few different routes we can take to clean up after ourselves a
> bit:
>
> A) Lock down these functions to 'categories'-only in favor of new,
> taxonomy-agnostic ones.
>
> B) Leave the functions alone but let the inline-docs and hard-coded
> strings such as 'No Categories' reflect their versatility. e.g. 'No
> Terms' vs 'No Categoriies'.
>
> C) Deprecate these older functions in deference to newer, taxonomy-
> agnostic ones.

New description:

 Spawning from a small discussion in #19776, I think it's about time
 something is done to deal with the older named category functions such as
 `wp_category_dropdown` and `wp_list_categories` in category-template.php

 These functions aren't technically category-only as they accept a set
 $taxonomy. And because they are actually taxonomy-agnostic, I think we
 have a few different routes we can take to clean up after ourselves a bit:

 A) Lock down these functions to 'categories'-only in favor of new,
 taxonomy-agnostic ones.

 B) Leave the functions alone but let the inline-docs and hard-coded
 strings such as 'No Categories' reflect their versatility. e.g. 'No Terms'
 vs 'No Categories'.

 C) Deprecate these older functions in deference to newer, taxonomy-
 agnostic ones.

--

-- 
Ticket URL: <http://core.trac.wordpress.org/ticket/19780#comment:2>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software