From 63535973cebfa8e3df6fa4a81a73c9933a14c05e Mon Sep 17 00:00:00 2001
From: Olivier Gorzalka <olivier@amphibee.fr>
Date: Tue, 13 Oct 2026 10:41:33 +0200
Subject: [PATCH] docs: WP-CLI subcommand names and dependency injection

---
 wp-cli-commands.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/wp-cli-commands.md b/wp-cli-commands.md
index bba6633..ef5daaa 100644
--- a/wp-cli-commands.md
+++ b/wp-cli-commands.md
@@ -92,7 +92,7 @@ class UserCreateCommand
 
 ## Command Suites (Subcommands)
 
-WP-CLI automatically registers all **public methods** as subcommands. Method names are converted to kebab-case.
+WP-CLI automatically registers all **public methods** as subcommands, under the method name as written: `listUsers()` answers to `listUsers`. For a kebab-case name, put `#[Command]` on the method: with no argument it derives `list-users` from the method name (see [Custom Subcommand Names](#custom-subcommand-names-with-command)).
 
 ```php
 <?php
@@ -137,7 +137,7 @@ class UserManagementCommand
 ```bash
 wp user-management create
 wp user-management delete
-wp user-management list-users
+wp user-management listUsers
 ```
 
 ### Custom Subcommand Names with #[Command]
@@ -205,6 +205,8 @@ The "Command" suffix is automatically removed:
 
 ### Method Name → Subcommand Slug
 
+With `#[Command]` and no argument, the slug is derived from the method name; without `#[Command]`, WP-CLI uses the method name as written.
+
 | Method Name | Generated Slug |
 |-------------|----------------|
 | `createUser()` | `create-user` |
@@ -521,6 +523,8 @@ public function __invoke(array $arguments, array $options): void
 
 ### Service Injection
 
+The command class is built with its constructor dependencies, and that instance runs the command and every subcommand. This needs `pollora/wp-cli` 0.1.1 or later (Pollora 13.36): before it, WP-CLI built the class itself, without arguments.
+
 ```php
 class MyCommand
 {