Parameter property extensions

[tmcw]

Documenting the elements of a destructured array argument

/** destructuring array */
function destructure([a: number, b: string]) {
}

Should result in something like

- $0[0] (number)
- $0[1] (string)

I think. It does not appear that JSDoc supports this style.

Questions:

• What to do about the names of the destructured results, like a and b here? When we're dealing with object destructuring, the names are ones that you provide, but here they aren't sensical, since arrays only have indexes. My first guess is to simply discard them.

[tmcw]

This was fixed in #732, yay! The answer is

- $0.0 (number)
- $0.1 (string)

No new syntax, and it's already supported in the JSDoc spec (and will hopefully be supported in doctrine master)..

The destructured param names don't matter the same way that destructuring-renaming, like function a({ b: c }) doesn't document c.