Improve comments

src/coffee/client.coffee

@@ -7,7 +7,19 @@ ProductService = require('./services/products')
 ###
 class SphereClient
 
+  ###*
+   * Constructs a new client with given API credentials
+   * @constructor
+   *
+   * @param {Object} config An object containing the credentials for the `sphere-node-connect`
+   * {@link https://github.com/emmenko/sphere-node-connect#documentation}
+  ###
   constructor: (config)->
+    ###*
+     * @private
+     * Instance of the Rest client
+     * @type {Rest}
+    ###
     @_rest = new Rest config
 
     # services

src/coffee/services/base.coffee

@@ -8,15 +8,21 @@ class BaseService
 
   ###*
    * Initialize the class.
-   * @param  {Rest} [_rest] an instance of the Rest client (sphere-node-connect)
-   * @return {BaseService}
+   * @constructor
+   *
+   * @param  {Rest} [_rest] An instance of the Rest client (sphere-node-connect)
   ###
   constructor: (@_rest)->
+    ###*
+     * @private
+     * Base path for a API resource endpoint (to be overriden by specific service)
+     * @type {String}
+    ###
     @_projectEndpoint = '/'
 
   ###*
    * Fetch resource defined by [_projectEndpoint]
-   * @return {Promise} a promise, fulfilled with an Object or rejected with a SphereError
+   * @return {Promise} A promise, fulfilled with an Object or rejected with a SphereError
   ###
   fetch: ->
     deferred = Q.defer()

src/coffee/services/products.coffee

@@ -8,12 +8,18 @@ class ProductService extends BaseService
 
   ###*
    * Initialize the class.
-   * @param  {Rest} [_rest] an instance of the Rest client (sphere-node-connect)
-   * @return {ProductService}
+   * @constructor
+   *
+   * @param  {Rest} [_rest] An instance of the Rest client `sphere-node-connect`
   ###
   constructor: (rest)->
     super(rest)
-    @_projectEndpoint = '/'
+    ###*
+     * @private
+     * Base path for Products endpoint.
+     * @type {String}
+    ###
+    @_projectEndpoint = '/products'
 
 ###*
  * The {@link ProductService} service.