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

…3454)

Co-authored-by: Jules Castéran <[email protected]>

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",