[wp-docs] Codex automated page creation for functions?

[Eric Lewis]

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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.automattic.com/pipermail/wp-docs/attachments/20111209/6acf5d08/attachment.htm>