docs(billing): add info about resellers (#4570)

Author: scaleway-bot

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

@@ -1,6 +1,9 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List all discounts for your organization and usable categories, products, offers, references, regions and zones where the discount can be applied.
+List all discounts for your Organization and usable categories, products, offers, references, regions and zones where the discount can be applied. As a reseller:
+- If you do not specify an `organization_id` you will list the discounts applied to your own Organization and your customers
+- If you indicate your `organization_id` you will list only the discounts applied to your Organization
+- If you indicate `the organization_id` of one of your customers, you will list the discounts applied to their Organization.
 
 USAGE:
   scw billing discount list [arg=value ...]

docs/commands/billing.md

@@ -70,7 +70,10 @@ Discount management commands.
 
 ### List discounts
 
-List all discounts for your organization and usable categories, products, offers, references, regions and zones where the discount can be applied.
+List all discounts for your Organization and usable categories, products, offers, references, regions and zones where the discount can be applied. As a reseller:
+- If you do not specify an `organization_id` you will list the discounts applied to your own Organization and your customers
+- If you indicate your `organization_id` you will list only the discounts applied to your Organization
+- If you indicate `the organization_id` of one of your customers, you will list the discounts applied to their Organization.
 
 **Usage:**
 

internal/namespaces/billing/v2beta1/billing_cli.go

@@ -376,8 +376,11 @@ func billingInvoiceDownload() *core.Command {
 
 func billingDiscountList() *core.Command {
 	return &core.Command{
-		Short:     `List discounts`,
-		Long:      `List all discounts for your organization and usable categories, products, offers, references, regions and zones where the discount can be applied.`,
+		Short: `List discounts`,
+		Long: `List all discounts for your Organization and usable categories, products, offers, references, regions and zones where the discount can be applied. As a reseller:
+- If you do not specify an ` + "`" + `organization_id` + "`" + ` you will list the discounts applied to your own Organization and your customers
+- If you indicate your ` + "`" + `organization_id` + "`" + ` you will list only the discounts applied to your Organization
+- If you indicate ` + "`" + `the organization_id` + "`" + ` of one of your customers, you will list the discounts applied to their Organization.`,
 		Namespace: "billing",
 		Resource:  "discount",
 		Verb:      "list",