docs(billing): specify for all tools (#3389)

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-billing-invoice-download-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Download billing resources.
+Download a specific invoice, specified by its ID.
 
 USAGE:
   scw billing invoice download [arg=value ...]

cmd/scw/testdata/test-all-usage-billing-invoice-list-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List billing resources.
+List all your invoices, filtering by `start_date` and `invoice_type`. Each invoice has its own ID.
 
 USAGE:
   scw billing invoice list [arg=value ...]

cmd/scw/testdata/test-all-usage-billing-invoice-usage.golden

@@ -6,8 +6,8 @@ USAGE:
   scw billing invoice <command>
 
 AVAILABLE COMMANDS:
-  download    Download billing resources
-  list        List billing resources
+  download    Download an invoice
+  list        List invoices
 
 FLAGS:
   -h, --help   help for invoice

docs/commands/billing.md

@@ -3,18 +3,18 @@
 Billing API.
 
 - [Invoices management commands](#invoices-management-commands)
-  - [Download billing resources](#download-billing-resources)
-  - [List billing resources](#list-billing-resources)
+  - [Download an invoice](#download-an-invoice)
+  - [List invoices](#list-invoices)
 
 
 ## Invoices management commands
 
 Invoices management commands.
 
 
-### Download billing resources
+### Download an invoice
 
-Download billing resources.
+Download a specific invoice, specified by its ID.
 
 **Usage:**
 
@@ -34,9 +34,9 @@ scw billing invoice download [arg=value ...]
 
 
 
-### List billing resources
+### List invoices
 
-List billing resources.
+List all your invoices, filtering by `start_date` and `invoice_type`. Each invoice has its own ID.
 
 **Usage:**
 

go.mod

@@ -24,7 +24,7 @@ require (
 	github.com/moby/buildkit v0.11.6
 	github.com/opencontainers/go-digest v1.0.0
 	github.com/pkg/errors v0.9.1
-	github.com/scaleway/scaleway-sdk-go v1.0.0-beta.21.0.20230927151821-5e183988cfb6
+	github.com/scaleway/scaleway-sdk-go v1.0.0-beta.21.0.20230928151303-2c2ba9cd7dfd
 	github.com/skratchdot/open-golang v0.0.0-20200116055534-eef842397966
 	github.com/spf13/cobra v1.7.0
 	github.com/spf13/pflag v1.0.5

go.sum

@@ -487,8 +487,8 @@ github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDN
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
 github.com/sabhiram/go-gitignore v0.0.0-20210923224102-525f6e181f06 h1:OkMGxebDjyw0ULyrTYWeN0UNCCkmCWfjPnIA2W6oviI=
 github.com/sabhiram/go-gitignore v0.0.0-20210923224102-525f6e181f06/go.mod h1:+ePHsJ1keEjQtpvf9HHw0f4ZeJ0TLRsxhunSI2hYJSs=
-github.com/scaleway/scaleway-sdk-go v1.0.0-beta.21.0.20230927151821-5e183988cfb6 h1:pDDuzt8ag2fUPEDEM1+BUrM/SemvjvmfOHQ1ptfa0EU=
-github.com/scaleway/scaleway-sdk-go v1.0.0-beta.21.0.20230927151821-5e183988cfb6/go.mod h1:fCa7OJZ/9DRTnOKmxvT6pn+LPWUptQAmHF/SBJUGEcg=
+github.com/scaleway/scaleway-sdk-go v1.0.0-beta.21.0.20230928151303-2c2ba9cd7dfd h1:2gTqwKzQa5ZY3oRyFr2dZKZ2fcDbG7vL5CqrPlzAYtI=
+github.com/scaleway/scaleway-sdk-go v1.0.0-beta.21.0.20230928151303-2c2ba9cd7dfd/go.mod h1:fCa7OJZ/9DRTnOKmxvT6pn+LPWUptQAmHF/SBJUGEcg=
 github.com/sclevine/spec v1.4.0 h1:z/Q9idDcay5m5irkZ28M7PtQM4aOISzOpj4bUPkDee8=
 github.com/secure-systems-lab/go-securesystemslib v0.4.0 h1:b23VGrQhTA8cN2CbBw7/FulN9fTtqYUdS5+Oxzt+DUE=
 github.com/sergi/go-diff v1.0.0/go.mod h1:0CfEIISq7TuYL3j771MWULgwwjU+GofnZX9QAmXWZgo=

internal/namespaces/billing/v2alpha1/billing_cli.go

@@ -44,8 +44,8 @@ func billingInvoice() *core.Command {
 
 func billingInvoiceList() *core.Command {
 	return &core.Command{
-		Short:     `List billing resources`,
-		Long:      `List billing resources.`,
+		Short:     `List invoices`,
+		Long:      `List all your invoices, filtering by ` + "`" + `start_date` + "`" + ` and ` + "`" + `invoice_type` + "`" + `. Each invoice has its own ID.`,
 		Namespace: "billing",
 		Resource:  "invoice",
 		Verb:      "list",
@@ -108,8 +108,8 @@ func billingInvoiceList() *core.Command {
 
 func billingInvoiceDownload() *core.Command {
 	return &core.Command{
-		Short:     `Download billing resources`,
-		Long:      `Download billing resources.`,
+		Short:     `Download an invoice`,
+		Long:      `Download a specific invoice, specified by its ID.`,
 		Namespace: "billing",
 		Resource:  "invoice",
 		Verb:      "download",