PDOCS-3233: Add permissions note to various serverless command descriptions

commands/activations.go

@@ -45,7 +45,7 @@ func Activations() *Command {
 			Use:   "activations",
 			Short: "Retrieve activation records",
 			Long: `The subcommands of ` + "`" + `doctl serverless activations` + "`" + ` retrieve results, logs, or complete
-activation records of functions deployed to your functions namespace.`,
+activation records of functions deployed to your functions namespace. This command requires the ` + "`" + `function:admin` + "`" + ` scope on your API token.`,
 			Aliases: []string{"activation", "actv"},
 		},
 	}

commands/functions.go

@@ -37,7 +37,7 @@ func Functions() *Command {
 		Command: &cobra.Command{
 			Use:     "functions",
 			Short:   "Work with the functions in your namespace",
-			Long:    `The subcommands of ` + "`" + `doctl serverless functions` + "`" + ` manage your functions namespace, such as listing, reviewing, and invoking your functions.`,
+			Long:    `The subcommands of ` + "`" + `doctl serverless functions` + "`" + ` manage your functions namespace, such as listing, reviewing, and invoking your functions. This command requires the ` + "`" + `function:admin` + "`" + ` scope on your API token.`,
 			Aliases: []string{"function", "fn"},
 		},
 	}

commands/serverless-extra.go

@@ -41,7 +41,7 @@ to choose your sample language for `+"`"+`doctl serverless init`+"`"+`.`,
 	deploy := CmdBuilder(cmd, RunServerlessExtraDeploy, "deploy <directory>", "Deploy a functions project to your functions namespace",
 		`At any time you can use `+"`"+`doctl serverless deploy`+"`"+` to upload the contents of a functions project in your file system for
 testing in your serverless namespace.  The project must be organized in the fashion expected by an App Platform Functions
-component.  The `+"`"+`doctl serverless init`+"`"+` command will create a properly organized directory for you to work in.`,
+component.  The `+"`"+`doctl serverless init`+"`"+` command will create a properly organized directory for you to work in. This command requires the `+"`"+`function:admin`+"`"+` scope on your API token.`,
 		Writer)
 	AddStringFlag(deploy, "env", "", "", "Path to runtime environment file")
 	AddStringFlag(deploy, "build-env", "", "", "Path to build-time environment file")

commands/serverless.go

@@ -92,7 +92,7 @@ The optional argument should be a (complete or partial) match to a namespace lab
 If there is no argument, all namespaces are matched.  If the result is exactly one namespace,
 you are connected to it.  If there are multiple namespaces, you have an opportunity to choose
 the one you want from a dialog.  Use `+"`"+`doctl serverless namespaces`+"`"+` to create, delete, and
-list your namespaces.`,
+list your namespaces. This command requires the `+"`"+`function:admin`+"`"+` scope on your API token.`,
 		Writer)
 	// The apihost and auth flags will always be hidden.  They support testing using doctl on clusters that are not in production
 	// and hence are unknown to the portal.