add short descriptions to users cli

EdwardAngert · EdwardAngert · commit 1eeae5ec9f54 · 2025-05-13T19:20:43.000Z
diff --git a/cli/testdata/coder_users_--help.golden b/cli/testdata/coder_users_--help.golden
@@ -10,10 +10,10 @@ USAGE:
 SUBCOMMANDS:
     activate      Update a user's status to 'active'. Active users can fully
                   interact with the platform
-    create        
+    create        Create a new user.
     delete        Delete a user by username or user_id.
     edit-roles    Edit a user's roles by username or id
-    list          
+    list          Prints the list of users.
     show          Show a single user. Use 'me' to indicate the currently
                   authenticated user.
     suspend       Update a user's status to 'suspended'. A suspended user cannot
diff --git a/cli/testdata/coder_users_create_--help.golden b/cli/testdata/coder_users_create_--help.golden
@@ -3,6 +3,8 @@ coder v0.0.0-devel
 USAGE:
   coder users create [flags]
 
+  Create a new user.
+
 OPTIONS:
   -O, --org string, $CODER_ORGANIZATION
           Select which organization (uuid or name) to use.
diff --git a/cli/testdata/coder_users_list_--help.golden b/cli/testdata/coder_users_list_--help.golden
@@ -3,6 +3,8 @@ coder v0.0.0-devel
 USAGE:
   coder users list [flags]
 
+  Prints the list of users.
+
   Aliases: ls
 
 OPTIONS:
diff --git a/cli/usercreate.go b/cli/usercreate.go
@@ -28,7 +28,8 @@ func (r *RootCmd) userCreate() *serpent.Command {
 	)
 	client := new(codersdk.Client)
 	cmd := &serpent.Command{
-		Use: "create",
+		Use:   "create",
+		Short: "Create a new user.",
 		Middleware: serpent.Chain(
 			serpent.RequireNArgs(0),
 			r.InitClient(client),
diff --git a/cli/userlist.go b/cli/userlist.go
@@ -23,6 +23,7 @@ func (r *RootCmd) userList() *serpent.Command {
 
 	cmd := &serpent.Command{
 		Use:     "list",
+		Short:   "Prints the list of users.",
 		Aliases: []string{"ls"},
 		Middleware: serpent.Chain(
 			serpent.RequireNArgs(0),
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -1625,6 +1625,7 @@
 						},
 						{
 							"title": "users create",
+							"description": "Create a new user.",
 							"path": "reference/cli/users_create.md"
 						},
 						{
@@ -1639,6 +1640,7 @@
 						},
 						{
 							"title": "users list",
+							"description": "Prints the list of users.",
 							"path": "reference/cli/users_list.md"
 						},
 						{
diff --git a/docs/reference/cli/users.md b/docs/reference/cli/users.md
diff --git a/docs/reference/cli/users_create.md b/docs/reference/cli/users_create.md
diff --git a/docs/reference/cli/users_list.md b/docs/reference/cli/users_list.md

Original file line number	Diff line number	Diff line change
`@@ -1625,6 +1625,7 @@`
`1625`	`1625`	`},`
`1626`	`1626`	`{`
`1627`	`1627`	`"title": "users create",`
	`1628`	`+ "description": "Create a new user.",`
`1628`	`1629`	`"path": "reference/cli/users_create.md"`
`1629`	`1630`	`},`
`1630`	`1631`	`{`
`@@ -1639,6 +1640,7 @@`
`1639`	`1640`	`},`
`1640`	`1641`	`{`
`1641`	`1642`	`"title": "users list",`
	`1643`	`+ "description": "Prints the list of users.",`
`1642`	`1644`	`"path": "reference/cli/users_list.md"`
`1643`	`1645`	`},`
`1644`	`1646`	`{`