diff --git a/lib/storage-service.js b/lib/storage-service.js
index 24c30c4..62221c8 100644
--- a/lib/storage-service.js
+++ b/lib/storage-service.js
@@ -11,8 +11,16 @@ module.exports = StorageService;
  * 
  * @options {Object} options The options to create a provider; see below.
  * @prop {Object} connector <!-- What is this? -->
- * @prop {String} provider Use 'filesystem' for local file system.  Other supported values are: 'amazon', 'rackspace', 'azure', and 'openstack'. 
- * @prop {String} root With 'filesystem' provider, the path to the root of storage directory.
+ * @prop {String} provider Storage service provider. Must be one of:
+ * <ul><li>'filesystem' - local file system.</li>
+ * <li>'amazon'</li>
+ * <li>'rackspace'</li>
+ * <li>'azure'</li>
+ * <li>'openstack'</li>
+ * </ul>
+ *
+ * Other supported values depend on the provider.
+ * See the [documentation](http://docs.strongloop.com/display/DOC/Storage+service) for more information.
  * @class
  */
 function StorageService(options) {
@@ -76,7 +84,8 @@ StorageService.prototype.getContainers = function (cb) {
  * <li>'openstack'</li>
  * </ul>
  *
- * Other supported values depend on the provider.  See the [documentation](http://docs.strongloop.com/display/DOC/Storage+service) for more information.
+ * Other supported values depend on the provider.
+ * See the [documentation](http://docs.strongloop.com/display/DOC/Storage+service) for more information.
  * @callback {Function} callback Callback function.
  */