So it looks like there was a massive effort to get PHPDoc into 2.7, for nearly everything. It's GREAT!! My thanks go out to all who participated.

My question today is, what to do about the Codex's Function Reference:
   http://codex.wordpress.org/Function_Reference

It has always been incomplete and out of sync with the code. Does wordpress.org have plans to have an official replacement, generated from the PHPDoc, so we can get rid of the Function Reference once and for all? There are several useful sites with cross-refs and such listed at the bottom of the above Codex page, but none are "official". Which would be the most useful? Are there any useful components of the Codex Function Reference that should be preserved? Thoughts?

And what about the Template Tags page in the Codex? That is also prone to being out of sync, and could be replaced by phpdoc, maybe? We could potentially link to the appropriate files that should contain template tags. Thoughts?

I am posting to Hackers and Doc, to get a cross section of opinions...

    --Jennifer

--
Jennifer Hodgdon * Poplar ProductivityWare
www.poplarware.com

Drupal/WordPress Sites, Themes, Modules/Plugins
Custom Web Programming, Web Databases
PHP, Perl, MySQL, JavaScript, XML, AJAX

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

Reply via email to