Hey all,

There are many websites out there that automatically parse the phpdoc of trunk, 
creating a very complete, although very big, documentation of WP core. 

Examples:

http://phpxref.com/xref/wordpress/_functions/index.html
wpseek.com

On WP.org there is this: http://phpdoc.wordpress.org/trunk/ which catalogs code 
in a similar manner.

I'm wondering why functions and their phpdoc are not hooked into the Codex at 
all, at least have pages made automatically for functions. It wouldn't clog the 
codex by creating tons of pages, because these functions won't be in a huge 
list anywhere, however where deemed appropriate functions can be linked to from 
the Functions Reference or anywhere else.

Perhaps a similar process could be employed for actions and hooks.

The reason I bring this up is because I just used media_sideload_image in a 
project I'm working on and realized there wasn't a Codex page for this 
function, which I made immediately. It would've been nice to at least have the 
PHPdoc there waiting for me, which I used to make the basis of the page.

Eric Lewis
_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs

Reply via email to