While working on https://gerrit.wikimedia.org/r/c/mediawiki/core/+/988730/7..8/resources/src/mediawiki.jqueryMsg/mediawiki.jqueryMsg.js#11 I tried to document like so:
/**
* @callback {Function} jQueryPlugins~MessageFormatterFunction
* @param {Array<string|string[]>} replacements Optional variable replacements (variadically or an array).
* This is a mixed array of strings or arrays of string. Change to
* when jsdoc theme has been patched.
* @return {jQuery} Rendered HTML.On publishing this triggers the cryptic message:
"WARNING: Unknown link (string|Array.<string>) in Namespace: jQueryPlugins"
Similarly when I run jsdoc on the following files:
'resources/src/mediawiki.tempUserBanner', 'resources/src/mediawiki.tempUserCreated',
I get
"WARNING: Ambiguous shortname: initTempUserBannerTooltip"