[wp-hackers] PHPDoc and state of the Codex

Alex King lists at alexking.org
Wed Oct 22 14:44:38 GMT 2008

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:


has an explanation like this:



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).

More information about the wp-hackers mailing list