diff --git a/modules/.eslintrc.json b/modules/.eslintrc.json index 270cfcbe1..178e0e09e 100644 --- a/modules/.eslintrc.json +++ b/modules/.eslintrc.json @@ -12,5 +12,18 @@ "rules": { "no-implicit-globals": "off", "max-len": "off" + }, + "settings": { + "jsdoc": { + "preferredTypes": { + "CommentController": "CommentController", + "CommentDetails": "CommentDetails", + "CommentItem": "CommentItem", + "DmMWPingNode": "DmMWPingNode", + "HeadingItem": "HeadingItem", + "moment": "moment", + "ThreadItem": "ThreadItem" + } + } } } diff --git a/modules/CommentController.js b/modules/CommentController.js index 109dd0761..e1464e96d 100644 --- a/modules/CommentController.js +++ b/modules/CommentController.js @@ -1,9 +1,3 @@ -/** - * @external CommentItem - * @external CommentDetails - * @external ThreadItem - */ - var controller = require( './controller.js' ), modifier = require( './modifier.js' ), diff --git a/modules/CommentItem.js b/modules/CommentItem.js index d2cdf7ce9..b12a12763 100644 --- a/modules/CommentItem.js +++ b/modules/CommentItem.js @@ -1,10 +1,5 @@ var ThreadItem = require( './ThreadItem.js' ); -/** - * @external moment - * @external HeadingItem - */ - /** * A comment item * diff --git a/modules/Parser.js b/modules/Parser.js index 1f493d98b..ac80ab1d1 100644 --- a/modules/Parser.js +++ b/modules/Parser.js @@ -1,10 +1,6 @@ 'use strict'; /* global $:off */ -/** - * @external ThreadItem - */ - var utils = require( './utils.js' ), codePointLength = require( 'mediawiki.String' ).codePointLength, diff --git a/modules/ThreadItem.js b/modules/ThreadItem.js index 9f848cc9b..a65cb431b 100644 --- a/modules/ThreadItem.js +++ b/modules/ThreadItem.js @@ -1,7 +1,4 @@ /* global moment */ -/** - * @external CommentItem - */ var utils = require( './utils.js' ); diff --git a/modules/controller.js b/modules/controller.js index b3ba034f4..11c1358d3 100644 --- a/modules/controller.js +++ b/modules/controller.js @@ -1,10 +1,5 @@ 'use strict'; -/** - * @external CommentItem - * @external CommentDetails - */ - var $pageContainer, linksController, featuresEnabled = mw.config.get( 'wgDiscussionToolsFeaturesEnabled' ) || {}, diff --git a/modules/dt-ve/dt.ce.PingNode.js b/modules/dt-ve/dt.ce.PingNode.js index 1f118a825..7c9449f34 100644 --- a/modules/dt-ve/dt.ce.PingNode.js +++ b/modules/dt-ve/dt.ce.PingNode.js @@ -5,10 +5,6 @@ * @license The MIT License (MIT); see LICENSE.txt */ -/** - * @external DmMWPingNode - */ - /** * ContentEditable MediaWiki ping node. * diff --git a/modules/dt.ui.ReplyWidget.js b/modules/dt.ui.ReplyWidget.js index e474b6bbb..60ffefa9a 100644 --- a/modules/dt.ui.ReplyWidget.js +++ b/modules/dt.ui.ReplyWidget.js @@ -10,12 +10,6 @@ var controller = require( 'ext.discussionTools.init' ).controller, require( './AbandonCommentDialog.js' ); require( './AbandonTopicDialog.js' ); -/** - * @external CommentController - * @external CommentItem - * @external CommentDetails - */ - /** * DiscussionTools ReplyWidget class * diff --git a/modules/dt.ui.ReplyWidgetPlain.js b/modules/dt.ui.ReplyWidgetPlain.js index afefb59e4..1b9881f2c 100644 --- a/modules/dt.ui.ReplyWidgetPlain.js +++ b/modules/dt.ui.ReplyWidgetPlain.js @@ -1,9 +1,3 @@ -/** - * @external CommentController - * @external CommentItem - * @external CommentDetails - */ - var utils = require( 'ext.discussionTools.init' ).utils; /** diff --git a/modules/dt.ui.ReplyWidgetVisual.js b/modules/dt.ui.ReplyWidgetVisual.js index d703f7752..5baa66708 100644 --- a/modules/dt.ui.ReplyWidgetVisual.js +++ b/modules/dt.ui.ReplyWidgetVisual.js @@ -8,12 +8,6 @@ require( './dt-ve/dt.ui.UsernameCompletionTool.js' ); require( './dt-ve/dt.dm.PingNode.js' ); require( './dt-ve/dt.ce.PingNode.js' ); -/** - * @external CommentController - * @external CommentItem - * @external CommentDetails - */ - /** * DiscussionTools ReplyWidgetVisual class * diff --git a/modules/modifier.js b/modules/modifier.js index 6836f6bed..a2351ddd8 100644 --- a/modules/modifier.js +++ b/modules/modifier.js @@ -1,10 +1,6 @@ 'use strict'; /* global $:off */ -/** - * @external CommentItem - */ - var utils = require( './utils.js' ); /** diff --git a/modules/utils.js b/modules/utils.js index 932b31743..303b0b829 100644 --- a/modules/utils.js +++ b/modules/utils.js @@ -1,10 +1,6 @@ 'use strict'; /* global $:off */ -/** - * @external ThreadItem - */ - /** * @constant */ diff --git a/tests/qunit/testUtils.js b/tests/qunit/testUtils.js index cc97ac097..9f37f442b 100644 --- a/tests/qunit/testUtils.js +++ b/tests/qunit/testUtils.js @@ -1,7 +1,3 @@ -/** - * @external CommentItem - */ - var utils = require( 'ext.discussionTools.init' ).utils; module.exports = {};