How to document an options argument ?

[luozhihua]

For example:

/**
 * Person Class
 * @class Person
 * @param {Object}  details Person details
 */
function Person(details) {
    this.name = details.name;
    this.department = details.department;
    // ...
}

I must to tell the other developers to know, That what properties are details allowed.

[neogeek]

Per the discussion found in issue #115 you can describe the properties of details like this:

/**
 * Person Class
 * @class Person
 * @param {Object} details Person details.
 * @param {Object} details.name Name of person.
 * @param {Object} details.department Department person works in.
 */

[luozhihua]

Thank's a lot!