[wp-hackers] PHPDoc and state of the Codex

[Alex King]

The Function Reference in the Codex is generally more in-depth with  
more examples than the PHPDoc. I believe that is useful, though it  
does get out of date and I'm sure is a bear to maintain.

For example, nothing here:

http://phpdoc.wordpress.org/trunk/WordPress/Query/WP_Query.html

has an explanation like this:

http://codex.wordpress.org/Function_Reference/WP_Query

Cheers,
--Alex

Personal   http://alexking.org
Business   http://crowdfavorite.com
Schedule   http://alex.myfreebusy.com



On Oct 22, 2008, at 8:40 AM, Jennifer Hodgdon wrote:

> But do you think that we need to save, specifically, the Function  
> Reference section of the Codex, given that we now have near-complete  
> PHPDoc? The Codex Function Reference was envisioned as a technical  
> API spec, but never lived up to that (wasn't complete, didn't keep  
> up with changes).