docs(serverless): rework documentation (#3026)

Co-authored-by: Rémy Léone <rleone@scaleway.com>

Author: scaleway-bot

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

@@ -1,15 +1,15 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Create a new cron.
+Create a new cronjob for a function with the specified ID.
 
 USAGE:
   scw function cron create [arg=value ...]
 
 ARGS:
-  [function-id]     
-  [schedule]        
-  [args]            
-  [name]            
+  [function-id]     UUID of the function to use the cron with
+  [schedule]        Schedule of the cron in UNIX cron format
+  [args]            Arguments to use with the cron
+  [name]            Name of the cron
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:

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

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Delete the cron associated with the given id.
+Delete the cron associated with the specified ID.
 
 USAGE:
   scw function cron delete <cron-id ...> [arg=value ...]
 
 ARGS:
-  cron-id           
+  cron-id           UUID of the cron to delete
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:

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

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Get the cron associated with the given id.
+Get the cron associated with the specified ID.
 
 USAGE:
   scw function cron get <cron-id ...> [arg=value ...]
 
 ARGS:
-  cron-id           
+  cron-id           UUID of the cron to get
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:

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

@@ -1,13 +1,13 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List all your crons.
+List all the cronjobs in a specified region.
 
 USAGE:
   scw function cron list [arg=value ...]
 
 ARGS:
-  [order-by]         (created_at_asc | created_at_desc)
-  [function-id]     
+  [order-by]        Order of the crons (created_at_asc | created_at_desc)
+  [function-id]     UUID of the function
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw | all)
 
 FLAGS:

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

@@ -1,16 +1,16 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Update the cron associated with the given id.
+Update the cron associated with the specified ID.
 
 USAGE:
   scw function cron update <cron-id ...> [arg=value ...]
 
 ARGS:
-  cron-id           
-  [function-id]     
-  [schedule]        
-  [args]            
-  [name]            
+  cron-id           UUID of the cron to update
+  [function-id]     UUID of the function to use the cron with
+  [schedule]        Schedule of the cron in UNIX cron format
+  [args]            Arguments to use with the cron
+  [name]            Name of the cron
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:

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

@@ -9,7 +9,7 @@ AVAILABLE COMMANDS:
   create      Create a new cron
   delete      Delete an existing cron
   get         Get a cron
-  list        List all your crons
+  list        List all crons
   update      Update an existing cron
 
 FLAGS:

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

@@ -1,13 +1,13 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Create a domain name binding.
+Create a domain name binding for the function with the specified ID.
 
 USAGE:
   scw function domain create [arg=value ...]
 
 ARGS:
-  [hostname]        
-  [function-id]     
+  [hostname]        Hostame to create
+  [function-id]     UUID of the function to associate the domain with
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:

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

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Delete a domain name binding.
+Delete a domain name binding for the function with the specified ID.
 
 USAGE:
   scw function domain delete <domain-id ...> [arg=value ...]
 
 ARGS:
-  domain-id         
+  domain-id         UUID of the domain to delete
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:

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

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Get a domain name binding.
+Get a domain name binding for the function with the specified ID.
 
 USAGE:
   scw function domain get <domain-id ...> [arg=value ...]
 
 ARGS:
-  domain-id         
+  domain-id         UUID of the domain to get
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:

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

@@ -1,13 +1,13 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List all domain name bindings.
+List all domain name bindings in a specified region.
 
 USAGE:
   scw function domain list [arg=value ...]
 
 ARGS:
-  [order-by]         (created_at_asc | created_at_desc | hostname_asc | hostname_desc)
-  [function-id]     
+  [order-by]        Order of the domains (created_at_asc | created_at_desc | hostname_asc | hostname_desc)
+  [function-id]     UUID of the function the domain is assoicated with
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw | all)
 
 FLAGS: