Define documentable types in eslintrc instead of inline

These types can be passed a parameters to any file without
creating a dependency, so it makes more sense to allow
the globally.

Change-Id: I5504465fd997b46547642e7046993b370b85586e

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"
+			}
+		}
 	}
 }

modules/CommentController.js

@@ -1,9 +1,3 @@
-/**
- * @external CommentItem
- * @external CommentDetails
- * @external ThreadItem
- */
-
 var
 	controller = require( './controller.js' ),
 	modifier = require( './modifier.js' ),

modules/CommentItem.js

@@ -1,10 +1,5 @@
 var ThreadItem = require( './ThreadItem.js' );
 
-/**
- * @external moment
- * @external HeadingItem
- */
-
 /**
  * A comment item
  *

modules/Parser.js

@@ -1,10 +1,6 @@
 'use strict';
 /* global $:off */
 
-/**
- * @external ThreadItem
- */
-
 var
 	utils = require( './utils.js' ),
 	codePointLength = require( 'mediawiki.String' ).codePointLength,

modules/ThreadItem.js

@@ -1,7 +1,4 @@
 /* global moment */
-/**
- * @external CommentItem
- */
 
 var utils = require( './utils.js' );
 

modules/controller.js

@@ -1,10 +1,5 @@
 'use strict';
 
-/**
- * @external CommentItem
- * @external CommentDetails
- */
-
 var
 	$pageContainer, linksController,
 	featuresEnabled = mw.config.get( 'wgDiscussionToolsFeaturesEnabled' ) || {},

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.
  *

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
  *

modules/dt.ui.ReplyWidgetPlain.js

@@ -1,9 +1,3 @@
-/**
- * @external CommentController
- * @external CommentItem
- * @external CommentDetails
- */
-
 var utils = require( 'ext.discussionTools.init' ).utils;
 
 /**

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
  *

modules/modifier.js

@@ -1,10 +1,6 @@
 'use strict';
 /* global $:off */
 
-/**
- * @external CommentItem
- */
-
 var utils = require( './utils.js' );
 
 /**

modules/utils.js

@@ -1,10 +1,6 @@
 'use strict';
 /* global $:off */
 
-/**
- * @external ThreadItem
- */
-
 /**
  * @constant
  */

tests/qunit/testUtils.js

@@ -1,7 +1,3 @@
-/**
- * @external CommentItem
- */
-
 var utils = require( 'ext.discussionTools.init' ).utils;
 
 module.exports = {};