Document WP-CLI contributor badge and association process

bin/Handbook_Command.php

@@ -138,6 +138,7 @@ function ( $parameter ) {
 				$api['related']     = array_values( $api['related'] );
 				$api['has_related'] = ! empty( $api['related'] );
 
+				// @phpstan-ignore argument.type
 				$api_doc = self::render( 'internal-api.mustache', $api );
 				$path    = self::get_handbook_path() . "/internal-api/{$api['api_slug']}.md";
 				if ( ! is_dir( dirname( $path ) ) ) {
@@ -215,6 +216,7 @@ function ( $parameter ) {
 				$api['related']     = array_values( $api['related'] );
 				$api['has_related'] = ! empty( $api['related'] );
 
+				// @phpstan-ignore argument.type
 				$api_doc = self::render( 'behat-steps.mustache', $api );
 				$path    = self::get_handbook_path() . "/behat-steps/{$api['api_slug']}.md";
 				if ( ! is_dir( dirname( $path ) ) ) {
@@ -301,6 +303,7 @@ private static function update_commands_data( $command, &$commands_data, $full )
 			$filename     = '';
 			$when_invoked = $reflection->getProperty( 'when_invoked' );
 			if ( PHP_VERSION_ID < 80100 ) {
+				// @phpstan-ignore method.deprecated
 				$when_invoked->setAccessible( true );
 			}
 			$closure            = $when_invoked->getValue( $command );

bin/handbook-manifest.json

@@ -850,5 +850,11 @@
         "slug": "wp-cli-warning",
         "markdown_source": "https:\/\/github.com\/wp-cli\/handbook\/blob\/main\/internal-api\/wp-cli-warning.md",
         "parent": "internal-api"
+    },
+    "cli-contributor-badge": {
+        "title": "WP-CLI Contributor Badge",
+        "slug": "cli-contributor-badge",
+        "markdown_source": "https:\/\/github.com\/wp-cli\/handbook\/blob\/main\/contributions\/cli-contributor-badge.md",
+        "parent": "contributions"
     }
 }

contributions/cli-contributor-badge.md

@@ -0,0 +1,21 @@
+# WP-CLI Contributor Badge
+
+The **WP-CLI Contributor Badge** recognizes individuals who have made meaningful contributions to the WP-CLI project. This badge is displayed on a contributor’s WordPress.org profile and highlights their involvement in maintaining and improving WP-CLI.
+
+## Eligibility criteria
+
+You may be eligible for the WP-CLI badge if you have made consistent and valuable contributions, including but not limited to:
+
+- Submitting or reviewing pull requests
+- Reporting bugs or helping triage issues
+- Significantly improving documentation
+- Participating in WP-CLI Hack Days or Contributor Days
+- Supporting users in WP-CLI-related discussions
+
+There is no strict minimum requirement. Contributions are evaluated based on quality, impact, and consistency.
+
+## Badge assignment process
+
+WP-CLI maintainers regularly review contributor activity across all WP-CLI repositories, typically after every release, and award badges to eligible contributors.
+
+**Note:** Please do not ping maintainers about the badges or try to request it yourself.

phpstan.neon.dist

@@ -5,7 +5,7 @@ parameters:
   scanDirectories:
     - vendor/wp-cli/wp-cli
   excludePaths:
-    - bin/packages
+    - bin/packages (?)
   treatPhpDocTypesAsCertain: false
   strictRules:
     strictCalls: true