Update flag description

JeffreyCA · JeffreyCA · commit 84603142875e · 2025-07-01T16:57:56.000Z
diff --git a/cli/azd/cmd/env.go b/cli/azd/cmd/env.go
@@ -822,7 +822,7 @@ func (f *envNewFlags) Bind(local *pflag.FlagSet, global *internal.GlobalCommandO
 		"Name or ID of an Azure subscription to use for the new environment",
 	)
 	local.StringVarP(&f.location, "location", "l", "", "Azure location for the new environment")
-	local.StringVarP(&f.envType, "type", "t", "", "Type of environment ('dev' or 'prod')")
+	local.StringVarP(&f.envType, "type", "t", "", "The type of the environment (e.g., dev, test, prod). (Experimental)")
 
 	f.global = global
 }
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-deploy.snap b/cli/azd/cmd/testdata/TestUsage-azd-deploy.snap
@@ -10,7 +10,7 @@ Usage
 
 Flags
         --all                 	: Deploys all services that are listed in azure.yaml
-        --env-type string     	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string     	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string  	: The name of the environment to use.
         --from-package string 	: Deploys the packaged service located at the provided path. Supports zipped file packages (file path) or container images (image tag).
 
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-down.snap b/cli/azd/cmd/testdata/TestUsage-azd-down.snap
@@ -5,7 +5,7 @@ Usage
   azd down [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --force              	: Does not require confirmation before it deletes resources.
         --purge              	: Does not require confirmation before it permanently deletes resources that are soft-deleted by default (for example, key vaults).
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-env-get-value.snap b/cli/azd/cmd/testdata/TestUsage-azd-env-get-value.snap
@@ -5,7 +5,7 @@ Usage
   azd env get-value <keyName> [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
 
 Global Flags
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-env-get-values.snap b/cli/azd/cmd/testdata/TestUsage-azd-env-get-values.snap
@@ -5,7 +5,7 @@ Usage
   azd env get-values [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
 
 Global Flags
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-env-new.snap b/cli/azd/cmd/testdata/TestUsage-azd-env-new.snap
@@ -7,7 +7,7 @@ Usage
 Flags
     -l, --location string     	: Azure location for the new environment
         --subscription string 	: Name or ID of an Azure subscription to use for the new environment
-    -t, --type string         	: Type of environment ('dev' or 'prod')
+    -t, --type string         	: The type of the environment (e.g., dev, test, prod). (Experimental)
 
 Global Flags
     -C, --cwd string 	: Sets the current working directory.
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-env-refresh.snap b/cli/azd/cmd/testdata/TestUsage-azd-env-refresh.snap
@@ -5,7 +5,7 @@ Usage
   azd env refresh <environment> [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --hint string        	: Hint to help identify the environment to refresh
 
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-env-set-secret.snap b/cli/azd/cmd/testdata/TestUsage-azd-env-set-secret.snap
@@ -5,7 +5,7 @@ Usage
   azd env set-secret <name> [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
 
 Global Flags
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-env-set.snap b/cli/azd/cmd/testdata/TestUsage-azd-env-set.snap
@@ -5,7 +5,7 @@ Usage
   azd env set [<key> <value>] | [<key>=<value> ...] | [--file <filepath>] [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --file string        	: Path to .env formatted file to load environment values from.
 
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-hooks-run.snap b/cli/azd/cmd/testdata/TestUsage-azd-hooks-run.snap
@@ -5,7 +5,7 @@ Usage
   azd hooks run <name> [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --platform string    	: Forces hooks to run for the specified platform.
         --service string     	: Only runs hooks for the specified service.
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-infra-generate.snap b/cli/azd/cmd/testdata/TestUsage-azd-infra-generate.snap
@@ -5,7 +5,7 @@ Usage
   azd infra generate [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --force              	: Overwrite any existing files without prompting
 
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-init.snap b/cli/azd/cmd/testdata/TestUsage-azd-init.snap
@@ -9,7 +9,7 @@ Usage
 
 Flags
     -b, --branch string       	: The template branch to initialize from. Must be used with a template argument (--template or -t).
-        --env-type string     	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string     	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string  	: The name of the environment to use.
     -f, --filter strings      	: The tag(s) used to filter template results. Supports comma-separated values.
         --from-code           	: Initializes a new application from your existing code.
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-monitor.snap b/cli/azd/cmd/testdata/TestUsage-azd-monitor.snap
@@ -5,7 +5,7 @@ Usage
   azd monitor [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --live               	: Open a browser to Application Insights Live Metrics. Live Metrics is currently not supported for Python apps.
         --logs               	: Open a browser to Application Insights Logs.
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-package.snap b/cli/azd/cmd/testdata/TestUsage-azd-package.snap
@@ -10,7 +10,7 @@ Usage
 
 Flags
         --all                	: Packages all services that are listed in azure.yaml
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --output-path string 	: File or folder path where the generated packages will be saved.
 
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-pipeline-config.snap b/cli/azd/cmd/testdata/TestUsage-azd-pipeline-config.snap
@@ -11,7 +11,7 @@ Usage
 Flags
     -m, --applicationServiceManagementReference string 	: Service Management Reference. References application or service contact information from a Service or Asset Management database. This value must be a Universally Unique Identifier (UUID). You can set this value globally by running azd config set pipeline.config.applicationServiceManagementReference <UUID>.
         --auth-type string                             	: The authentication type used between the pipeline provider and Azure for deployment (Only valid for GitHub provider). Valid values: federated, client-credentials.
-        --env-type string                              	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string                              	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string                           	: The name of the environment to use.
         --principal-id string                          	: The client id of the service principal to use to grant access to Azure resources as part of the pipeline.
         --principal-name string                        	: The name of the service principal to use to grant access to Azure resources as part of the pipeline.
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-provision.snap b/cli/azd/cmd/testdata/TestUsage-azd-provision.snap
@@ -10,7 +10,7 @@ Usage
   azd provision [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --no-state           	: Do not use latest Deployment State (bicep only).
         --preview            	: Preview changes to Azure resources.
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-restore.snap b/cli/azd/cmd/testdata/TestUsage-azd-restore.snap
@@ -9,7 +9,7 @@ Usage
 
 Flags
         --all                	: Restores all services that are listed in azure.yaml
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
 
 Global Flags
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-show.snap b/cli/azd/cmd/testdata/TestUsage-azd-show.snap
@@ -5,7 +5,7 @@ Usage
   azd show [resource name or ID] [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
         --show-secrets       	: Unmask secrets in output.
 
diff --git a/cli/azd/cmd/testdata/TestUsage-azd-up.snap b/cli/azd/cmd/testdata/TestUsage-azd-up.snap
@@ -20,7 +20,7 @@ Usage
   azd up [flags]
 
 Flags
-        --env-type string    	: The type of the environment (e.g., dev, test, prod). Used when creating new environments.
+        --env-type string    	: The type of the environment (e.g., dev, test, prod). (Experimental)
     -e, --environment string 	: The name of the environment to use.
 
 Global Flags
diff --git a/cli/azd/internal/env_flag.go b/cli/azd/internal/env_flag.go
@@ -47,7 +47,7 @@ func (e *EnvFlag) Bind(local *pflag.FlagSet, global *GlobalCommandOptions) {
 		EnvironmentTypeFlagName,
 		// Set the default value to AZURE_ENV_TYPE value if available
 		e.fromEnvTypeVarValue,
-		"The type of the environment (e.g., dev, test, prod). Used when creating new environments.")
+		"The type of the environment (e.g., dev, test, prod). (Experimental)")
 }
 
 // checks if the environment name was set from the command line

Original file line number	Diff line number	Diff line change
`@@ -822,7 +822,7 @@ func (f envNewFlags) Bind(local pflag.FlagSet, global *internal.GlobalCommandO`
`822`	`822`	`"Name or ID of an Azure subscription to use for the new environment",`
`823`	`823`	`)`
`824`	`824`	`local.StringVarP(&f.location, "location", "l", "", "Azure location for the new environment")`
`825`		`- local.StringVarP(&f.envType, "type", "t", "", "Type of environment ('dev' or 'prod')")`
	`825`	`+ local.StringVarP(&f.envType, "type", "t", "", "The type of the environment (e.g., dev, test, prod). (Experimental)")`
`826`	`826`
`827`	`827`	`f.global = global`
`828`	`828`	`}`