CiviCRM Community Forums (archive)

I like phpdoc and how the http://api.civicrm.org/v3/ looks.

I think we should push it one step futher though

1. Should provide good description and possibly code sample *or where the function has been called
2. A search interface by method name that will return classname::method_name or classname->method_name.

I think doing these 2 things can help greatly encouraging more developers to be involved in the project.


Back to Lobo: Be gladly to participate in this documentation team thingy



Cheers!

civicrm_api_{entity}_{action} are NOT supposed to be called directly.

Call civicrm_api ('entity', 'action', $params) it will do what's needed and call the right function.

If some zendstudio/sed guru wants to add automatically a line of comment DON'T CALL DIRECTLY, call civicrm_api ()

before each function, might avoid some problems

X+