fix(functions): add short and long descriptions to triggers methods (#3454)

Co-authored-by: Jules Castéran <jcasteran@scaleway.com>

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-function-trigger-create-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Create function resources.
+Create a new trigger for a specified function.
 
 USAGE:
   scw function trigger create [arg=value ...]

cmd/scw/testdata/test-all-usage-function-trigger-delete-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Delete function resources.
+Delete a trigger with a specified ID.
 
 USAGE:
   scw function trigger delete <trigger-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-function-trigger-get-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Get function resources.
+Get a trigger with a specified ID.
 
 USAGE:
   scw function trigger get <trigger-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-function-trigger-list-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List function resources.
+List all triggers belonging to a specified Organization or Project.
 
 USAGE:
   scw function trigger list [arg=value ...]

cmd/scw/testdata/test-all-usage-function-trigger-update-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Update function resources.
+Update a trigger with a specified ID.
 
 USAGE:
   scw function trigger update <trigger-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-function-trigger-usage.golden

@@ -6,11 +6,11 @@ USAGE:
   scw function trigger <command>
 
 AVAILABLE COMMANDS:
-  create      Create function resources
-  delete      Delete function resources
-  get         Get function resources
-  list        List function resources
-  update      Update function resources
+  create      Create a trigger
+  delete      Delete a trigger
+  get         Get a trigger
+  list        List all triggers
+  update      Update a trigger
 
 FLAGS:
   -h, --help   help for trigger

docs/commands/function.md

@@ -38,11 +38,11 @@ Function as a Service API.
   - [Get a token](#get-a-token)
   - [List all tokens](#list-all-tokens)
 - [Trigger management commands](#trigger-management-commands)
-  - [Create function resources](#create-function-resources)
-  - [Delete function resources](#delete-function-resources)
-  - [Get function resources](#get-function-resources)
-  - [List function resources](#list-function-resources)
-  - [Update function resources](#update-function-resources)
+  - [Create a trigger](#create-a-trigger)
+  - [Delete a trigger](#delete-a-trigger)
+  - [Get a trigger](#get-a-trigger)
+  - [List all triggers](#list-all-triggers)
+  - [Update a trigger](#update-a-trigger)
 
 
 ## Cron management commands
@@ -725,9 +725,9 @@ scw function token list [arg=value ...]
 Trigger management commands.
 
 
-### Create function resources
+### Create a trigger
 
-Create function resources.
+Create a new trigger for a specified function.
 
 **Usage:**
 
@@ -756,9 +756,9 @@ scw function trigger create [arg=value ...]
 
 
 
-### Delete function resources
+### Delete a trigger
 
-Delete function resources.
+Delete a trigger with a specified ID.
 
 **Usage:**
 
@@ -776,9 +776,9 @@ scw function trigger delete <trigger-id ...> [arg=value ...]
 
 
 
-### Get function resources
+### Get a trigger
 
-Get function resources.
+Get a trigger with a specified ID.
 
 **Usage:**
 
@@ -796,9 +796,9 @@ scw function trigger get <trigger-id ...> [arg=value ...]
 
 
 
-### List function resources
+### List all triggers
 
-List function resources.
+List all triggers belonging to a specified Organization or Project.
 
 **Usage:**
 
@@ -819,9 +819,9 @@ scw function trigger list [arg=value ...]
 
 
 
-### Update function resources
+### Update a trigger
 
-Update function resources.
+Update a trigger with a specified ID.
 
 **Usage:**
 

internal/namespaces/function/v1beta1/function_cli.go

@@ -1481,8 +1481,8 @@ func functionTokenDelete() *core.Command {
 
 func functionTriggerCreate() *core.Command {
 	return &core.Command{
-		Short:     `Create function resources`,
-		Long:      `Create function resources.`,
+		Short:     `Create a trigger`,
+		Long:      `Create a new trigger for a specified function.`,
 		Namespace: "function",
 		Resource:  "trigger",
 		Verb:      "create",
@@ -1586,8 +1586,8 @@ func functionTriggerCreate() *core.Command {
 
 func functionTriggerGet() *core.Command {
 	return &core.Command{
-		Short:     `Get function resources`,
-		Long:      `Get function resources.`,
+		Short:     `Get a trigger`,
+		Long:      `Get a trigger with a specified ID.`,
 		Namespace: "function",
 		Resource:  "trigger",
 		Verb:      "get",
@@ -1616,8 +1616,8 @@ func functionTriggerGet() *core.Command {
 
 func functionTriggerList() *core.Command {
 	return &core.Command{
-		Short:     `List function resources`,
-		Long:      `List function resources.`,
+		Short:     `List all triggers`,
+		Long:      `List all triggers belonging to a specified Organization or Project.`,
 		Namespace: "function",
 		Resource:  "trigger",
 		Verb:      "list",
@@ -1671,8 +1671,8 @@ func functionTriggerList() *core.Command {
 
 func functionTriggerUpdate() *core.Command {
 	return &core.Command{
-		Short:     `Update function resources`,
-		Long:      `Update function resources.`,
+		Short:     `Update a trigger`,
+		Long:      `Update a trigger with a specified ID.`,
 		Namespace: "function",
 		Resource:  "trigger",
 		Verb:      "update",
@@ -1715,8 +1715,8 @@ func functionTriggerUpdate() *core.Command {
 
 func functionTriggerDelete() *core.Command {
 	return &core.Command{
-		Short:     `Delete function resources`,
-		Long:      `Delete function resources.`,
+		Short:     `Delete a trigger`,
+		Long:      `Delete a trigger with a specified ID.`,
 		Namespace: "function",
 		Resource:  "trigger",
 		Verb:      "delete",