diff --git a/lib/registry.js b/lib/registry.js
index bb905da2..c1d21082 100644
--- a/lib/registry.js
+++ b/lib/registry.js
@@ -78,7 +78,7 @@ registry.createModel = function (name, properties, options) {
  * });
  * ```
  *
- * @options {Object} model configuration
+ * @options {Object} config model configuration
  * @property {String} name Unique name.
  * @property {Object} [properties] Model properties
  * @property {Object} [options] Model options. Options can be specified on the
@@ -121,7 +121,7 @@ function buildModelOptionsFromConfig(config) {
 /**
  * Alter an existing Model class.
  * @param {Model} ModelCtor The model constructor to alter.
- * @options {Object} Additional configuration to apply
+ * @options {Object} config Additional configuration to apply
  * @property {DataSource} dataSource Attach the model to a dataSource.
  * @property {Object} [relations] Model relations to add/update.
  *
@@ -185,9 +185,10 @@ registry.getModelByType = function(modelType) {
  * Create a data source with passing the provided options to the connector.
  *
  * @param {String} name Optional name.
- * @options {Object} Data Source options
+ * @options {Object} options Data Source options
  * @property {Object} connector LoopBack connector.
- * @property {*} Other properties See the relevant connector documentation.
+ * @property {*} [*] Other connector properties.
+ *   See the relevant connector documentation.
  *
  * @header loopback.createDataSource(name, options)
  */