From 8396437cb8875b51764ed473d2e42b6060a65777 Mon Sep 17 00:00:00 2001
From: Umherirrender <umherirrender_de.wp@web.de>
Date: Thu, 11 Jan 2018 17:33:57 +0100
Subject: [PATCH] Improve some parameter docs

Change-Id: I1d6bece3380b6d2144feee512de736c12d62d09e
---
 .phpcs.xml                  |  5 +----
 ContributionScores_body.php | 12 ++++++------
 2 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/.phpcs.xml b/.phpcs.xml
index e656bbd..482be95 100644
--- a/.phpcs.xml
+++ b/.phpcs.xml
@@ -1,8 +1,6 @@
 <?xml version="1.0"?>
 <ruleset>
 	<rule ref="./vendor/mediawiki/mediawiki-codesniffer/MediaWiki">
-		<exclude name="MediaWiki.Commenting.FunctionComment.MissingParamName" />
-		<exclude name="MediaWiki.Commenting.FunctionComment.MissingParamTag" />
 		<exclude name="MediaWiki.Files.ClassMatchesFilename.NotMatch" />
 		<exclude name="MediaWiki.Commenting.FunctionComment.MissingDocumentationProtected" />
 		<exclude name="MediaWiki.Commenting.FunctionComment.MissingDocumentationPublic" />
@@ -11,6 +9,5 @@
 	</rule>
 	<file>.</file>
 	<arg name="extensions" value="php,php5,inc" />
-	<arg name="encoding" value="utf8" />
-	<exclude-pattern>vendor</exclude-pattern>
+	<arg name="encoding" value="UTF-8" />
 </ruleset>
diff --git a/ContributionScores_body.php b/ContributionScores_body.php
index 1fe0ae0..0b0c50f 100644
--- a/ContributionScores_body.php
+++ b/ContributionScores_body.php
@@ -21,11 +21,11 @@ class ContributionScores extends IncludableSpecialPage {
 	/**
 	 * Function generates Contribution Scores tables in HTML format (not wikiText)
 	 *
-	 * @param $days int Days in the past to run report for
-	 * @param $limit int Maximum number of users to return (default 50)
-	 * @param $title Title (default null)
-	 * @param $options array of options (default none; nosort/notools)
-	 * @return Html Table representing the requested Contribution Scores.
+	 * @param int $days Days in the past to run report for
+	 * @param int $limit Maximum number of users to return (default 50)
+	 * @param string|null $title The title of the table
+	 * @param array $options array of options (default none; nosort/notools)
+	 * @return string Html Table representing the requested Contribution Scores.
 	 */
 	function genContributionScoreTable( $days, $limit, $title = null, $options = 'none' ) {
 		global $wgContribScoreIgnoreBots, $wgContribScoreIgnoreBlockedUsers, $wgContribScoresUseRealName;
@@ -188,7 +188,7 @@ class ContributionScores extends IncludableSpecialPage {
 	/**
 	 * Called when being included on a normal wiki page.
 	 * Cache is disabled so it can depend on the user language.
-	 * @param $par
+	 * @param string|null $par A subpage give to the special page
 	 */
 	function showInclude( $par ) {
 		$days = null;