对象数组如何注释 about styleguide HOT 3 OPEN

/**
 * @typedef {{ name: string; level: number }} Person
 **/

/** @types {Person[]} */
const persons = [{
   { name: "集鹄大叔", level: 9999 },
   { name: "胡子大叔", level: 1 },
}];

/**
 * 数字数组参数注释
 *
 * @param {Array.<number>} nums 数字数组
 */
function showNums(nums) {
    // ...
}

/**
 * 对象参数注释
 *
 * @param {Object} user 用户
 * @param {string} user.name 用户姓名
 * @param {number} user.age 用户年龄
 */
function showUser(user) {
    // ...
}

/**
 * 对象数组参数注释
 *
 * @param {Array.<Object>} users 用户数组
 * @param {string} users[i].name 用户姓名
 * @param {number} users[i].age 用户年龄
 */
function showUsers(users) {
    // ...
}

/**
 * Assign the project to a list of employees.
 * @param {Object[]} employees - The employees who are responsible for the project.
 * @param {string} employees[].name - The name of an employee.
 * @param {string} employees[].department - The employee's department.
 */
Project.prototype.assign = function(employees) {
    // ...
};