feat(cli): add coder users delete command (#10115)

docs/api/users.md

@@ -346,9 +346,9 @@ curl -X GET http://coder-server:8080/api/v2/users/{user} \
 
 ### Parameters
 
-| Name   | In   | Type   | Required | Description          |
-| ------ | ---- | ------ | -------- | -------------------- |
-| `user` | path | string | true     | User ID, name, or me |
+| Name   | In   | Type   | Required | Description              |
+| ------ | ---- | ------ | -------- | ------------------------ |
+| `user` | path | string | true     | User ID, username, or me |
 
 ### Example responses
 

docs/cli/users.md

@@ -20,6 +20,7 @@ coder users [subcommand]
 | -------------------------------------------- | ------------------------------------------------------------------------------------- |
 | [<code>activate</code>](./users_activate.md) | Update a user's status to 'active'. Active users can fully interact with the platform |
 | [<code>create</code>](./users_create.md)     |                                                                                       |
+| [<code>delete</code>](./users_delete.md)     | Delete a user by username or user_id.                                                 |
 | [<code>list</code>](./users_list.md)         |                                                                                       |
 | [<code>show</code>](./users_show.md)         | Show a single user. Use 'me' to indicate the currently authenticated user.            |
 | [<code>suspend</code>](./users_suspend.md)   | Update a user's status to 'suspended'. A suspended user cannot log into the platform  |

docs/cli/users_delete.md

@@ -0,0 +1,15 @@
+<!-- DO NOT EDIT | GENERATED CONTENT -->
+
+# users delete
+
+Delete a user by username or user_id.
+
+Aliases:
+
+- rm
+
+## Usage
+
+```console
+coder users delete <username|user_id>
+```

docs/cli/users_suspend.md

@@ -4,11 +4,6 @@
 
 Update a user's status to 'suspended'. A suspended user cannot log into the platform
 
-Aliases:
-
-- rm
-- delete
-
 ## Usage
 
 ```console

docs/manifest.json

@@ -885,6 +885,11 @@
           "title": "users create",
           "path": "cli/users_create.md"
         },
+        {
+          "title": "users delete",
+          "description": "Delete a user by username or user_id.",
+          "path": "cli/users_delete.md"
+        },
         {
           "title": "users list",
           "path": "cli/users_list.md"