Merge pull request #788 from PHPCSStandards/feature/docs-various-fixes

Docs: various minor fixes

Author: jrfnl

Diff for: src/Standards/Generic/Sniffs/NamingConventions/UpperCaseConstantNameSniff.php

@@ -121,7 +121,7 @@ public function process(File $phpcsFile, $stackPtr)
         $constName = $tokens[$constPtr]['content'];
         $prefix    = '';
 
-        // Strip namespace from constant like /foo/bar/CONSTANT.
+        // Strip namespace from constant like \foo\bar\CONSTANT.
         $splitPos = strrpos($constName, '\\');
         if ($splitPos !== false) {
             $prefix    = substr($constName, 0, ($splitPos + 1));

Diff for: tests/Core/Ruleset/RuleInclusionTest.php

@@ -450,7 +450,7 @@ public function testSettingInvalidPropertiesOnStandardsAndCategoriesSilentlyFail
      *
      * @see self::testSettingInvalidPropertiesOnStandardsAndCategoriesSilentlyFails()
      *
-     * @return array<string, array>string, string>>
+     * @return array<string, array<string, string>>
      */
     public static function dataSettingInvalidPropertiesOnStandardsAndCategoriesSilentlyFails()
     {

Diff for: tests/Core/Ruleset/ShowSniffDeprecationsTest.php

@@ -256,7 +256,7 @@ public function testDeprecatedSniffsListDoesNotShowWhenAllDeprecatedSniffsAreExc
 
 
     /**
-     * Test deprecated sniffs are listed alphabetically in the deprecated sniffs warning.
+     * Test various aspects of the deprecated sniffs warning.
      *
      * This tests a number of different aspects:
      * 1. That the summary line uses the correct grammar when there is are multiple deprecated sniffs.
@@ -321,7 +321,7 @@ public function testDeprecatedSniffsWarning()
 
 
     /**
-     * Test deprecated sniffs are listed alphabetically in the deprecated sniffs warning.
+     * Test the report width is respected when displaying the deprecated sniffs warning.
      *
      * This tests the following aspects:
      * 1. That the summary line uses the correct grammar when there is a single deprecated sniff.