compute: Add help text for default value of --version when it is optional

CHANGELOG.md

@@ -14,6 +14,9 @@
 
 ### Enhancements:
 
+- docs(compute): for `compute deploy` and `compute publish`, the `--version` help now says that the flag is optional and
+  defaults to the active version, or to the latest version if none is active.
+
 ### Dependencies:
 - build(deps): `github.com/andybalholm/brotli` from 1.2.3 to 1.2.4 ([#1913](https://github.com/fastly/cli/pull/1913))
 - build(deps): `github.com/mattn/go-runewidth` from 0.0.29 to 0.0.30 ([#1913](https://github.com/fastly/cli/pull/1913))

pkg/argparser/common.go

@@ -29,6 +29,10 @@ var (
 	FlagVersionName = "version"
 	// FlagVersionDesc is the flag description.
 	FlagVersionDesc = "'latest', 'active', 'staged', or the number of a specific Fastly service version"
+	// FlagVersionOptionalDesc is the flag description for commands where the
+	// version flag is optional. It describes what OptionalServiceVersion.Parse
+	// does when the flag is omitted.
+	FlagVersionOptionalDesc = FlagVersionDesc + " (default: the active version, or the latest version if none is active)"
 )
 
 // PaginationDirection is a list of directions the page results can be displayed.

pkg/commands/compute/deploy.go

@@ -83,7 +83,7 @@ func NewDeployCommand(parent argparser.Registerer, g *global.Data) *DeployComman
 	})
 	c.RegisterFlag(argparser.StringFlagOpts{
 		Action:      c.ServiceVersion.Set,
-		Description: argparser.FlagVersionDesc,
+		Description: argparser.FlagVersionOptionalDesc,
 		Dst:         &c.ServiceVersion.Value,
 		Name:        argparser.FlagVersionName,
 	})

pkg/commands/compute/publish.go

@@ -81,7 +81,7 @@ func NewPublishCommand(parent argparser.Registerer, g *global.Data, build *Build
 	c.CmdClause.Flag("status-check-timeout", "Set a timeout (in seconds) for the service availability check").Default("120").IntVar(&c.statusCheckTimeout)
 	c.RegisterFlag(argparser.StringFlagOpts{
 		Name:        argparser.FlagVersionName,
-		Description: argparser.FlagVersionDesc,
+		Description: argparser.FlagVersionOptionalDesc,
 		Dst:         &c.serviceVersion.Value,
 		Action:      c.serviceVersion.Set,
 	})