Merge "Add tooling for documentation"

jsduck.json

@@ -0,0 +1,34 @@
+{
+	"--title": "MinervaNeue - Documentation",
+	"--output": "docs",
+	"--processes": "0",
+	"--warnings-exit-nonzero": true,
+	"--builtin-classes": true,
+	"--external": [
+		"Hogan.Template",
+		"HandleBars.Template",
+		"jQuery.Deferred",
+		"jQuery.Promise",
+		"jQuery.Event",
+		"jQuery.Object",
+		"jqXHR",
+		"View",
+		"Page",
+		"File",
+		"Router",
+		"MainMenu",
+		"mw.user",
+		"mw.Api",
+		"mw.ForeignApi",
+		"OO.ui.ToolGroup",
+		"OO.ui.Tool",
+		"OO.ui.mixin.LookupElement",
+		"OO.EventEmitter",
+		"ve.init.mw.MobileArticleTarget",
+		"mw.echo.dm.NotificationItem"
+	],
+	"--warnings": ["-nodoc(class,public)", "-dup_member", "-link_ambiguous"],
+	"--": [
+		"resources"
+	]
+}

package.json

@@ -1,9 +1,11 @@
 {
 	"private": true,
 	"scripts": {
-		"test": "grunt test && dev-scripts/svg_check.sh"
+		"test": "grunt test && npm run doc && dev-scripts/svg_check.sh",
+		"doc": "jsduck"
 	},
 	"dependencies": {
+		"jsdoc": "3.4.2",
 		"svgo": ">=0.4.4"
 	},
 	"devDependencies": {

resources/skins.minerva.mainMenu/MainMenu.js

@@ -17,11 +17,8 @@
 	}
 
 	OO.mfExtend( MainMenu, View, {
-		/** @inheritdoc */
 		isTemplateMode: true,
-		/** @inheritdoc */
 		template: mw.template.get( 'skins.minerva.mainMenu', 'menu.hogan' ),
-		/** @inheritdoc */
 		templatePartials: {
 			menuGroup: mw.template.get( 'skins.minerva.mainMenu', 'menuGroup.hogan' )
 		},
@@ -51,7 +48,6 @@
 			} );
 		},
 		/**
-		 * @inheritdoc
 		 * Remove the nearby menu entry if the browser doesn't support geo location
 		 */
 		postRender: function () {

resources/skins.minerva.notifications.badge/NotificationBadge.js

@@ -31,7 +31,6 @@
 
 	OO.mfExtend( NotificationBadge, View, {
 		/**
-		 * @inheritdoc
 		 * @cfg {Object} defaults Default options hash.
 		 * @cfg {String} defaults.notificationIconClass e.g. mw-ui-icon for icon
 		 * @cfg {String} defaults.loadingIconHtml for spinner
@@ -45,9 +44,6 @@
 			hasUnseenNotifications: false,
 			notificationCount: 0
 		},
-		/**
-		 * @inheritdoc
-		 */
 		isBorderBox: false,
 		/**
 		 * Loads a ResourceLoader module script. Shows ajax loader whilst loading.
@@ -107,7 +103,6 @@
 				} );
 			} );
 		},
-		/** @inheritdoc */
 		template: mw.template.get( 'skins.minerva.notifications.badge', 'badge.hogan' ),
 		/**
 		 * Click handler for clicking on the badge