docs: add descriptions to cobra commands

cmd/identities/delete.go

@@ -13,6 +13,7 @@ import (
 
 var deleteCmd = &cobra.Command{
 	Use:  "delete",
+	Short: "Delete identities by ID",
 	Args: cobra.MinimumNArgs(1),
 	Run: func(cmd *cobra.Command, args []string) {
 		c := cliclient.NewClient(cmd)

cmd/identities/get.go

@@ -13,6 +13,7 @@ import (
 
 var getCmd = &cobra.Command{
 	Use:  "get <id>",
+	Short: "Get an identity by ID",
 	Args: cobra.ExactArgs(1),
 	Run: func(cmd *cobra.Command, args []string) {
 		c := cliclient.NewClient(cmd)

cmd/identities/put.go → cmd/identities/import.go

@@ -20,6 +20,8 @@ import (
 // putCmd represents the import command
 var putCmd = &cobra.Command{
 	Use: "import <file.json [file-2.json [file-3.json] ...]>",
+	Short: "Import identities from files or STD_IN",
+	Long: "Import identities from files or STD_IN. Files are expected to each contain a single identity. The validity of files can be tested beforehand using the `validate` command.",
 	Run: importIdentities,
 }
 

cmd/identities/list.go

@@ -16,6 +16,8 @@ import (
 
 var listCmd = &cobra.Command{
 	Use: "list [<page> <per-page>]",
+	Short: "List identities",
+	Long: "List identities (paginated)",
 	Args: func(cmd *cobra.Command, args []string) error {
 		// zero or exactly two args
 		if len(args) != 0 && len(args) != 2 {

cmd/identities/patch.go

@@ -8,6 +8,7 @@ import (
 
 var patchCmd = &cobra.Command{
 	Use:  "patch <file.json [file-2.json [file-3.json] ...]>",
+	Short: "Patch identities by ID (not yet implemented)",
 	Args: cobra.MinimumNArgs(1),
 	Run: func(cmd *cobra.Command, args []string) {
 		// TODO

cmd/identities/root.go

@@ -11,6 +11,7 @@ import (
 // identitiesCmd represents the identity command
 var identitiesCmd = &cobra.Command{
 	Use: "identities",
+	Short: "Tools to interact with remote identities",
 }
 
 func RegisterCommandRecursive(parent *cobra.Command) {

cmd/identities/validate.go

@@ -22,6 +22,7 @@ import (
 
 var validateCmd = &cobra.Command{
 	Use:  "validate  <file.json [file-2.json [file-3.json] ...]>",
+	Short: "Validate local identity files",
 	Args: cobra.MinimumNArgs(1),
 	Run: func(cmd *cobra.Command, args []string) {
 		c := cliclient.NewClient(cmd)