4.0 dev upgrade guide: minor formatting tweaks

Author: jrfnl

wiki/Version-4.0-Developer-Upgrade-Guide.md

@@ -52,7 +52,7 @@ There is a separate [[Upgrade Guide for Ruleset Maintainers and End-Users|Versio
 It is highly recommended to upgrade external standards and integrations as soon as you are able.
 
 Once PHP_CodeSniffer 4.0 has been released, the PHP_CodeSniffer 3.x branch will no longer receive updates, with the exception of security fixes and runtime compatibility fixes for new PHP versions.
-This "limited support" will last a maximum of one year from the date of the PHP_Codesniffer 4.0.0 release.
+This "limited support" will last a maximum of one year from the date of the PHP_CodeSniffer 4.0.0 release.
 
 > [!IMPORTANT]
 > This also means that support for new PHP syntaxes will only land in PHP_CodeSniffer 4.x and will **NOT** be backported to the 3.x branch.
@@ -519,7 +519,7 @@ The `protected` `getDeclarationNameWithNamespace()` and `getNamespaceOfScope()`
 
 * `PHP_CodeSniffer\Ruleset::setSniffProperty()`: the BC-layer supporting the old array format for the `$settings` parameter for the method has been removed.
     The `$settings` parameter must be passed as an array with the following two keys: `'scope'` and `'value'`, with `'scope'` being set to either `'sniff'` or `'standard'`, and `'value'` containing the new property value.
-    Also see https://github.com/squizlabs/PHP_CodeSniffer/pull/3629
+    Also see [squizlabs/PHP_CodeSniffer#3629](https://github.com/squizlabs/PHP_CodeSniffer/pull/3629).
 
 * Various class properties have been replaced with class constants. Where these were in the public API (= the below list), the properties still exist, but are now (soft) deprecated and will be removed in PHP_CodeSniffer 5.0.
   The visibility of the (deprecated) properties and their class constant replacements is the same.
@@ -544,9 +544,9 @@ The `protected` `getDeclarationNameWithNamespace()` and `getNamespaceOfScope()`
 | (`protected`) `PHP_CodeSniffer\Standards\Squiz\Sniffs\PHP\DisallowSizeFunctionsInLoopsSniff::$forbiddenFunctions` | `PHP_CodeSniffer\Standards\Squiz\Sniffs\PHP\DisallowSizeFunctionsInLoopsSniff::FORBIDDEN_FUNCTIONS` | |
 
 * The visibility of the following class constants has changed from `public` to `private`. If you used these in your own code, you will need to create your own constants instead:
-    - `PHP_CodeSniffer\Generators\HTML::STYLESHEET`
-    - `PHP_CodeSniffer\Util\Timing::MINUTE_IN_MS`
-    - `PHP_CodeSniffer\Util\Timing::SECOND_IN_MS`
+    * `PHP_CodeSniffer\Generators\HTML::STYLESHEET`
+    * `PHP_CodeSniffer\Util\Timing::MINUTE_IN_MS`
+    * `PHP_CodeSniffer\Util\Timing::SECOND_IN_MS`
 
 * The `PHP_CodeSniffer\Util\Standards::printInstalledStandards()` method is deprecated and should no longer be used. Use `echo PHP_CodeSniffer\Util\Standards::prepareInstalledStandardsForDisplay()` instead once support for PHPCS 3.x is being dropped.
 
@@ -578,7 +578,7 @@ If an external standard uses its own test framework, this section can be skipped
 * The test setup now supports PHPUnit 8, 9, 10 and 11, which is in line with the new minimum PHP version of 7.2.
     Please read the changelogs for PHPUnit itself for information about the changes.
     Most notable changes which will likely impact your tests:
-    - The test suite may need a separate PHPUnit config file for PHPUnit < 10 and PHPUnit 10+.
+    * The test suite may need a separate PHPUnit config file for PHPUnit < 10 and PHPUnit 10+.
 * The custom `TestSuite` setup has been removed from the framework as it is no longer needed since PEAR support was dropped and was incompatible with PHPUnit 10.
 * All abstract base test cases now use the `TestCase` class name suffix.
     | Old Name                                              | New Name                                              |
@@ -589,22 +589,22 @@ If an external standard uses its own test framework, this section can be skipped
     These methods now have `void` return type declarations.
 * The global `printPHPCodeSnifferTestOutput()` function, which printed a "# sniff test files generated # unique error codes; # were fixable (#%)" summary after the tests is no longer available.
 * The following properties which were previously available in the `AbstractSniffUnitTest` class have been removed:
-    - `protected $backupGlobals`
-    - `public $standardsDir`
-    - `public $testsDir`
+    * `protected $backupGlobals`
+    * `public $standardsDir`
+    * `public $testsDir`
     The first is (very) old-school PHPUnit and should not be used anyway.
     The last two were never intended to be overwritten by concrete test classes, so shouldn't have been public properties.
 * The following property which was previously available in the `AbstractMethodUnitTest` class has been removed:
-    - `protected static $fileExtension`
+    * `protected static $fileExtension`
        This property is redundant now support for JS/CSS files has been dropped.
 * The test framework no longer uses global variables. I.e. the following are no longer available:
-    - `$GLOBALS['PHP_CODESNIFFER_STANDARD_DIRS']`
-    - `$GLOBALS['PHP_CODESNIFFER_TEST_DIRS']`
-    - `$GLOBALS['PHP_CODESNIFFER_CONFIG']`
-    - `$GLOBALS['PHP_CODESNIFFER_RULESETS']`
-    - `$GLOBALS['PHP_CODESNIFFER_SNIFF_CASE_FILES']`
-    - `$GLOBALS['PHP_CODESNIFFER_SNIFF_CODES']`
-    - `$GLOBALS['PHP_CODESNIFFER_FIXABLE_CODES']`
+    * `$GLOBALS['PHP_CODESNIFFER_STANDARD_DIRS']`
+    * `$GLOBALS['PHP_CODESNIFFER_TEST_DIRS']`
+    * `$GLOBALS['PHP_CODESNIFFER_CONFIG']`
+    * `$GLOBALS['PHP_CODESNIFFER_RULESETS']`
+    * `$GLOBALS['PHP_CODESNIFFER_SNIFF_CASE_FILES']`
+    * `$GLOBALS['PHP_CODESNIFFER_SNIFF_CODES']`
+    * `$GLOBALS['PHP_CODESNIFFER_FIXABLE_CODES']`
 * Sniff tests which extend the `AbstractSniffTestCase` for which no test case files (`.inc` files) can be found, will now be marked as "incomplete".
 * Sniff tests which extend the `AbstractSniffTestCase` for which no `.fixed` files can be found, while the sniff would make fixes to the test case file, will now fail.