(minor)
The current output for optional method parameters (say, @param {String|Int} [position] This param does this and that.) looks as follows:

It might be nicer to get a more compact output, without adding the “Argument” column, say:

Remark: as a matter of fact, such an output can be already obtained using
@param {String|Int} position <i>Optional</i><br/>If reference is a...
that is without using the special JSDoc syntax for optional arguments. But I think this wouldn't be a good solution.
(minor)
The current output for optional method parameters (say,
@param {String|Int} [position] This param does this and that.) looks as follows:It might be nicer to get a more compact output, without adding the “Argument” column, say:
Remark: as a matter of fact, such an output can be already obtained using
that is without using the special JSDoc syntax for optional arguments. But I think this wouldn't be a good solution.