diff --git a/lib/storage-service.js b/lib/storage-service.js
index 5382c3c..4a20b8d 100644
--- a/lib/storage-service.js
+++ b/lib/storage-service.js
@@ -190,8 +190,8 @@ StorageService.prototype.removeFile = function (container, file, cb) {
   return this.client.removeFile(container, file, cb);
 };
 
-/*!
- * Upload middleware for the HTTP request/response
+/**
+ * Upload middleware for the HTTP request/response  <!-- Should this be documented? -->
  * @param {Request} req Request object
  * @param {Response} res Response object
  * @param {Function} cb Callback function
@@ -200,8 +200,8 @@ StorageService.prototype.upload = function (req, res, cb) {
   return handler.upload(this.client, req, res, req.params.container, cb);
 };
 
-/*!
- * Download middleware
+/**
+ * Download middleware <!-- Should this be documented? -->
  * @param {String} container Container name
  * @param {String} file File name
  * @param {Response} res HTTP response
@@ -285,4 +285,4 @@ StorageService.prototype.download.accepts = [
   {arg: 'res', type: 'object', 'http': {source: 'res'}}
 ];
 StorageService.prototype.download.http =
-{verb: 'get', path: '/:container/download/:file'};
\ No newline at end of file
+{verb: 'get', path: '/:container/download/:file'};