Update docs for promise returns

[Mechazawa]

Change syntax from a descriptive one to a more declarative one:
Before:

/**
 * @returns {Promise} - Resolves with {@link ResourceBase} instance and rejects with {@link ApiError}
 */

After:

/**
 * @returns {Promise<ResourceBase, ApiError>} - A description of the actual contents of the response
 */