Decorating method parameters with since or new

[ryan-nauman]

We've had a few releases where new parameters have been added to our methods. We call them out in a guide but it would be nice if we could decorate these with new/since tags. I don't have any great ideas as to how this could be displayed in the output. It seems like it would add a lot of noise to the parameters section but maybe a subtle icon or tooltip for new parameters could be a solution.

What do you think?

[nene]

This has been suggested before.

Using @since tags for parameters is problematic, but I actually think the use of explicit @since tags in general is problematic. A much better approach is to let JSDuck do the comparison of source code from different versions, and produce the since-data automatically. (I think this whole --import feature is severely under-documented).

So, it would be feasible to produce the version data for parameters automatically. But adding this information explicitly feels noisy.

[nene]

I went ahead and implemented automatic generation of this data for parameters:

As can be seen, the version info is only shown when the parameter was introduced in a later version than the method itself.

[nene]

It's now merged into jsduck master and will be part of the next release. 3916999