docs(edge_services): add precision on forwarding behavior (#5445)

Co-authored-by: Yacine Fodil <105779815+yfodil@users.noreply.github.com>

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-edge-services-route-stage-create-usage.golden

@@ -1,14 +1,14 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Create a new route stage. You must specify the `waf_stage_id` field to customize the route.
+Create a new route stage. You must specify the `waf_stage_id` or `backend_stage_id` fields to customize the route.
 
 USAGE:
   scw edge-services route-stage create [arg=value ...]
 
 ARGS:
   pipeline-id          Pipeline ID the route stage belongs to
   [waf-stage-id]       ID of the WAF stage HTTP requests should be forwarded to when no rules are matched
-  [backend-stage-id]   
+  [backend-stage-id]   ID of the backend stage HTTP requests should be forwarded to when no rules are matched
 
 FLAGS:
   -h, --help                help for create

cmd/scw/testdata/test-all-usage-edge-services-route-stage-update-usage.golden

@@ -8,7 +8,7 @@ USAGE:
 ARGS:
   route-stage-id       ID of the route stage to update
   [waf-stage-id]       ID of the WAF stage HTTP requests should be forwarded to when no rules are matched
-  [backend-stage-id]   
+  [backend-stage-id]   ID of the backend stage HTTP requests should be forwarded to when no rules are matched
 
 FLAGS:
   -h, --help                help for update

docs/commands/edge-services.md

@@ -725,7 +725,7 @@ Route-stage management commands.
 
 ### Create route stage
 
-Create a new route stage. You must specify the `waf_stage_id` field to customize the route.
+Create a new route stage. You must specify the `waf_stage_id` or `backend_stage_id` fields to customize the route.
 
 **Usage:**
 
@@ -740,7 +740,7 @@ scw edge-services route-stage create [arg=value ...]
 |------|---|-------------|
 | pipeline-id | Required | Pipeline ID the route stage belongs to |
 | waf-stage-id |  | ID of the WAF stage HTTP requests should be forwarded to when no rules are matched |
-| backend-stage-id |  |  |
+| backend-stage-id |  | ID of the backend stage HTTP requests should be forwarded to when no rules are matched |
 
 
 
@@ -819,7 +819,7 @@ scw edge-services route-stage update <route-stage-id ...> [arg=value ...]
 |------|---|-------------|
 | route-stage-id | Required | ID of the route stage to update |
 | waf-stage-id |  | ID of the WAF stage HTTP requests should be forwarded to when no rules are matched |
-| backend-stage-id |  |  |
+| backend-stage-id |  | ID of the backend stage HTTP requests should be forwarded to when no rules are matched |
 
 
 

internal/namespaces/edge_services/v1beta1/edge_services_cli.go

@@ -1812,7 +1812,7 @@ func edgeServicesRouteStageList() *core.Command {
 func edgeServicesRouteStageCreate() *core.Command {
 	return &core.Command{
 		Short:     `Create route stage`,
-		Long:      `Create a new route stage. You must specify the ` + "`" + `waf_stage_id` + "`" + ` field to customize the route.`,
+		Long:      `Create a new route stage. You must specify the ` + "`" + `waf_stage_id` + "`" + ` or ` + "`" + `backend_stage_id` + "`" + ` fields to customize the route.`,
 		Namespace: "edge-services",
 		Resource:  "route-stage",
 		Verb:      "create",
@@ -1835,6 +1835,7 @@ func edgeServicesRouteStageCreate() *core.Command {
 			},
 			{
 				Name:       "backend-stage-id",
+				Short:      `ID of the backend stage HTTP requests should be forwarded to when no rules are matched`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
@@ -1906,6 +1907,7 @@ func edgeServicesRouteStageUpdate() *core.Command {
 			},
 			{
 				Name:       "backend-stage-id",
+				Short:      `ID of the backend stage HTTP requests should be forwarded to when no rules are matched`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,