[wp-docs] Re: [wp-hackers] Deprecated functions in the codex

[Jennifer Hodgdon]

Hacker Scot wrote:
> The user experience of landing on a Codex page for a deprecated function 
> is lousy.
> 
> http://codex.wordpress.org/Template_Tags/get_links
> 
> "This function has been deprecated. That means it has been replaced by a 
> new function or is no longer supported, and may be removed from future 
> versions. All code that uses this function should be converted to use 
> its replacement if one exists."
> 
> OK, so what function should you use instead? No hint whatsoever on that 
> page. 

You are correct, it would be good if the new function to use was 
indicated. Some of the deprecated functions in the codex have been 
marked with this, and some haven't. If you figure out which function 
should be used, please edit the codex page and add that to the 
documentation.

You can also mark the page as "in need of editing" in the codex, and 
put a "talk" item explaining it needs a reference to the new function 
to use.

The Codex is a continual "work in progress" and a volunteer effort. I 
believe it is improving, but it can improve faster if you help. By the 
way, the "docs" mailing list is the correct venue for this discussion, 
not "hackers".

Thanks,
     Jennifer

-- 
Jennifer Hodgdon

Poplar ProductivityWare * www.poplarware.com
Web Databases/Scripts * Modeling/Analysis/Palm OS Software