that's a good example, just add that error is either false or a CAPIError object and that response is a Response object. Do not add this in the first method but rather on the very first document block in the file which documents the class. For instance, UserService this would give

```js
    /**
     * Creates an instance of user service object. Should be retrieved from CAPI instance (see example).
     *
     * ## Note on the *callbacks* usage
     *
     * The *callback* argument of the service methods always take 2 arguments:
     *    
     *    * `error` either `false` or {{#crossLink "CAPIError"}}CAPIError{{/crossLink}}
     *       object when an error occurred
     *    * `response` the {{#crossLink "Response"}}Response{{/crossLink}} object
     *
     * Example:
     *
     *     userService.loadRootUserGroup(function (error, response) {
     *        if ( error ) {
     *            console.log('An error occurred', error);
     *        } else {
     *            console.log('Success!', response);
     *        }
     *     });
     *
     * @class UserService
     * @constructor
     * @param connectionManager {ConnectionManager} connection manager that will be used to send requests to REST service
     * @param discoveryService {DiscoveryService} discovery service is used for urls auto-discovery automation
     * @example
     *     var userService = jsCAPI.getUserService();
     */
    var UserService = function(connectionManager, discoveryService) {
```

which results in:

![capidoc](https://f.cloud.github.com/assets/305563/1136656/5f5bb7e8-1c49-11e3-8636-6e09d3055eac.png)