HTML output: Display all levels of parameter properties.

[MichelSimonot]

Hello,

I ran into an issue where certain portions of the JSON output was not being included in the HTML output. Specifically, properties underneath parameter properties (section.params.properties.properties). These sub-properties are included in the MD output, so I assumed they should be part of the HTML output. So here's my fix.

JSDoc

// testFile.js
/**
 * Documentation for some function.
 * @name testFunction
 * @param {Object} options An options parameter.
 * @param  {Object} options.firstLevelOne A property of the options parameter.
 * @param  {Boolean} options.firstLevelOne.secondLevelOne A second level property.
 * @param  {Boolean} options.firstLevelOne.secondLevelTwo A second second level property.
 * @param  {Boolean} options.firstLevelTwo A second first level property.
 */
export function testFunction(options) {
    return options;
}

Expected HTML Output

Actual HTML Output

As above, but both of the secondLevel... property rows are omitted.

The sub-properties were being omitted because section._ only iterates over param.properties and doesn't check for anything underneath it (here). So I created a new template (paramProperty._) (to replace that portion of section._) that recursively checks for properties and renders them (here). With this, the actual HTML output matches [my] expected HTML output.

I updated the test case input (html/nested.input.js) to include a case for this, but haven't updated the snapshots to reflect the new output. Wasn't sure what your process is for this.

[coveralls]

Coverage decreased (-0.06%) to 86.031% when pulling ae2bdf3 on MichelSimonot:master into e203df5 on documentationjs:master.

[tmcw]

Awesome! What I usually do to update snapshots is run ./node_modules/.bin/jest -u, which should do it.

[coveralls]

Coverage decreased (-0.06%) to 86.031% when pulling 1e7e1bc on MichelSimonot:master into e203df5 on documentationjs:master.

[tmcw]

👍 Awesome, thanks!