new python folder: update language (#8223)

<!-- Thank you for submitting a pull request.
If this is your first pull request you can find information about
contributing here:
  * https://github.com/posit-dev/positron/blob/main/CONTRIBUTING.md

We recommend synchronizing your branch with the latest changes in the
main branch by either pulling or rebasing.
-->

<!--
  Describe briefly what problem this pull request resolves, or what
  new feature it introduces. Include screenshots of any new or altered
  UI. Link to any GitHub issues but avoid "magic" keywords that will
  automatically close the issue. If there are any details about your
  approach that are unintuitive or you want to draw attention to, please
  describe them here.
-->
Addresses part of #8040.

Slight modifications of the language used in the Python step of the New
Folder Flow for clarity.

Defaults:
<img width="696" alt="image"
src="https://github.com/user-attachments/assets/f380ab2d-e561-40fc-8e1a-50a81c2c45b7"
/>

New dropdown:
<img width="553" alt="image"
src="https://github.com/user-attachments/assets/88c89aed-fe1f-40b7-b24b-81218f8b53bf"
/>

If you select venv:
<img width="691" alt="image"
src="https://github.com/user-attachments/assets/e60e3db6-338f-4e46-9396-c668bc9be7a1"
/>

If you select "use existing":
<img width="692" alt="image"
src="https://github.com/user-attachments/assets/32009545-72c2-49ba-9000-ca3299b2774c"
/>



### Release Notes

<!--
Optionally, replace `N/A` with text to be included in the next release
notes.
The `N/A` bullets are ignored. If you refer to one or more Positron
issues,
these issues are used to collect information about the feature or
bugfix, such
as the relevant language pack as determined by Github labels of type
`lang: `.
  The note will automatically be tagged with the language.

These notes are typically filled by the Positron team. If you are an
external
  contributor, you may ignore this section.
-->

#### New Features

- N/A

#### Bug Fixes

- N/A


### QA Notes

<!--
Positron team members: please add relevant e2e test tags, so the tests
can be
  run when you open this pull request.

- Instructions:
https://github.com/posit-dev/positron/blob/main/test/e2e/README.md#pull-requests-and-test-tags
- Available tags:
https://github.com/posit-dev/positron/blob/main/test/e2e/infra/test-runner/test-tags.ts
-->
@:new-folder-flow

<!--
  Add additional information for QA on how to validate the change,
  paying special attention to the level of risk, adjacent areas that
  could be affected by the change, and any important contextual
  information not present in the linked issues.
-->
Just click around these menus; behavior should not be changed

Author: austin3dickey

extensions/positron-python/src/client/common/utils/localize.ts

@@ -480,7 +480,10 @@ export namespace CreateEnv {
         export const installingPackages = l10n.t('Installing packages...');
         export const errorCreatingEnvironment = l10n.t('Error while creating virtual environment.');
         export const selectPythonPlaceHolder = l10n.t('Select a Python installation to create the virtual environment');
-        export const providerDescription = l10n.t('Creates a `.venv` virtual environment in the current workspace');
+        // --- Start Positron ---
+        // export const providerDescription = l10n.t('Creates a `.venv` virtual environment in the current workspace');
+        export const providerDescription = l10n.t('Select an existing interpreter for the new environment');
+        // --- End Positron ---
         export const error = l10n.t('Creating virtual environment failed with error.');
         export const tomlExtrasQuickPickTitle = l10n.t('Select optional dependencies to install from pyproject.toml');
         export const requirementsQuickPickTitle = l10n.t('Select dependencies to install');
@@ -507,7 +510,10 @@ export namespace CreateEnv {
             'Select the version of Python to install in the environment',
         );
         export const creating = l10n.t('Creating conda environment...');
-        export const providerDescription = l10n.t('Creates a `.conda` Conda environment in the current workspace');
+        // --- Start Positron ---
+        // export const providerDescription = l10n.t('Creates a `.conda` Conda environment in the current workspace');
+        export const providerDescription = l10n.t('Use conda to install a Python version for the new environment');
+        // --- End Positron ---
 
         export const recreate = l10n.t('Delete and Recreate');
         export const recreateDescription = l10n.t('Delete existing ".conda" environment and create a new one');
@@ -522,7 +528,9 @@ export namespace CreateEnv {
 
     // --- Start Positron ---
     export namespace Uv {
-        export const providerDescription = l10n.t('Creates a `uv` virtual environment in the current workspace');
+        export const providerDescription = l10n.t(
+            'Use uv to find a Python version locally (or install it if needed) for the new environment',
+        );
     }
     // --- End Positron ---
 

src/vs/workbench/browser/positronNewFolderFlow/components/steps/pythonEnvironmentStep.tsx

@@ -120,14 +120,14 @@ export const PythonEnvironmentStep = (props: PropsWithChildren<NewFolderFlowStep
 			identifier: EnvironmentSetupType.NewEnvironment,
 			title: localize(
 				'pythonEnvironmentStep.newEnvironment.radioLabel',
-				"Create a new Python environment (Recommended)"
+				"Create a new virtual environment (Recommended)"
 			)
 		}),
 		new RadioButtonItem({
 			identifier: EnvironmentSetupType.ExistingEnvironment,
 			title: localize(
 				'pythonEnvironmentStep.existingEnvironment.radioLabel',
-				"Use an existing Python installation"
+				"Use an existing environment"
 			)
 		})
 	];
@@ -335,26 +335,31 @@ export const PythonEnvironmentStep = (props: PropsWithChildren<NewFolderFlowStep
 
 	// Construct the interpreter dropdown title.
 	const interpreterDropdownTitle = () => {
+		const interpreterOrVersion = (context.usesCondaEnv || context.usesUvEnv) ? 'version' : 'interpreter';
+
 		// If interpreters is undefined, show a loading message.
 		if (interpretersLoading()) {
 			return localize(
 				'pythonInterpreterSubStep.dropDown.title.loading',
-				"Loading interpreters..."
+				"Loading {0}s...",
+				interpreterOrVersion
 			);
 		}
 
 		// If interpreters is empty, show a message that no interpreters were found.
 		if (!interpretersAvailable()) {
 			return localize(
 				'pythonInterpreterSubStep.dropDown.title.noInterpreters',
-				"No interpreters found."
+				"No {0}s found.",
+				interpreterOrVersion
 			);
 		}
 
 		// Otherwise, show the default title.
 		return localize(
 			'pythonInterpreterSubStep.dropDown.title',
-			"Select a Python interpreter"
+			"Select a Python {0}",
+			interpreterOrVersion
 		);
 	};
 
@@ -447,14 +452,14 @@ export const PythonEnvironmentStep = (props: PropsWithChildren<NewFolderFlowStep
 						<FlowFormattedText type={FlowFormattedTextType.Info}>
 							{(() => localize(
 								'pythonEnvironmentSubStep.description',
-								"Select a Python environment"
+								"Select a way to create a new virtual environment"
 							))()}
 						</FlowFormattedText>
 					}
 					feedback={envProviderStepFeedback()}
 					title={(() => localize(
 						'pythonEnvironmentSubStep.label',
-						"Python Environment"
+						"Environment Creation"
 					))()}
 				>
 					<DropDownListBox
@@ -478,17 +483,24 @@ export const PythonEnvironmentStep = (props: PropsWithChildren<NewFolderFlowStep
 			}
 			{/* Show the Python interpreter dropdown */}
 			<PositronFlowSubStep
-				description={(() =>
-					localize(
+				description={(() => {
+					const whatToSelect = (context.usesCondaEnv || context.usesUvEnv) ? 'a Python version' : 'an existing interpreter';
+					return localize(
 						'pythonInterpreterSubStep.description',
-						"Select a Python interpreter"
-					))()}
+						"Select {0}",
+						whatToSelect
+					)
+				})()}
 				feedback={interpreterStepFeedback()}
-				title={(() =>
-					localize(
+				title={(() => {
+					const interpreterOrVersion = (context.usesCondaEnv || context.usesUvEnv) ? 'Version' : 'Interpreter';
+					return localize(
 						'pythonInterpreterSubStep.title',
-						"Python Interpreter"
-					))()}
+						"Python {0}",
+						interpreterOrVersion
+					)
+				})()}
+				titleId='pythonEnvironment-interpreterOrVersion'
 			>
 				<DropDownListBox
 					createItem={(item) => (

test/e2e/pages/newFolderFlow.ts

@@ -15,10 +15,10 @@ export class NewFolderFlow {
 	private folderTemplateButton = (label: string) => this.code.driver.page.locator('label').filter({ hasText: label });
 	private folderNameInput = this.code.driver.page.getByLabel(/Enter the name of your new/);
 	private existingEnvRadioButton = this.code.driver.page.getByText(/Use an existing/);
-	private envProviderDropdown = this.code.driver.page.locator('#flow-sub-step-python-environment').locator('button');
+	private envProviderDropdown = this.code.driver.page.locator('#flow-sub-step-environment-creation').locator('button');
 	private envProviderDropdownTitle = this.envProviderDropdown.locator('.dropdown-entry-title');
 	private dropDropdownOptions = this.code.driver.page.locator('.positron-modal-popup-children').getByRole('button');
-	private interpreterDropdown = this.code.driver.page.locator('#flow-sub-step-python-interpreter').locator('button');
+	private interpreterDropdown = this.code.driver.page.locator('#flow-sub-step-pythonenvironment-interpreterorversion').locator('button');
 	private interpreterDropdownSubtitle = this.interpreterDropdown.locator('.dropdown-entry-subtitle');
 
 	constructor(private code: Code, private quickaccess: QuickAccess) { }