Page MenuHomePhabricator

Cryptic warnings inside publish.js on valid JSDoc
Closed, DeclinedPublicBUG REPORT

Description

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"

Event Timeline

This seems related to use of @ignore. and pages populating global.html so I don't think it's a problem.