From 82e8fec68d6b1581f0830ddf09616839c743817f Mon Sep 17 00:00:00 2001 From: Courtney Webster <60238438+cwebster-99@users.noreply.github.com> Date: Fri, 22 Mar 2024 08:49:35 -0500 Subject: [PATCH] Updates to walkthrough (microsoft/vscode-python#23107) - Updating walkthrough based on previous experiment - Updating based on https://github.com/microsoft/vscode-python/issues/22664 Co-authored-by: Eleanor Boyd --- extensions/positron-python/package.json | 21 ++++---------- extensions/positron-python/package.nls.json | 31 +++++++++++++++++---- 2 files changed, 31 insertions(+), 21 deletions(-) diff --git a/extensions/positron-python/package.json b/extensions/positron-python/package.json index 543a8fad0b21..998332812e0f 100644 --- a/extensions/positron-python/package.json +++ b/extensions/positron-python/package.json @@ -168,16 +168,6 @@ "description": "%walkthrough.pythonWelcome.description%", "when": "false", "steps": [ - { - "id": "python.createPythonFolder", - "title": "%walkthrough.step.python.createPythonFolder.title%", - "description": "%walkthrough.step.python.createPythonFolder.description%", - "media": { - "svg": "resources/walkthrough/open-folder.svg", - "altText": "%walkthrough.step.python.createPythonFile.altText%" - }, - "when": "workspaceFolderCount = 0" - }, { "id": "python.createPythonFile", "title": "%walkthrough.step.python.createPythonFile.title%", @@ -222,14 +212,15 @@ "title": "%walkthrough.step.python.createEnvironment.title2%", "description": "%walkthrough.step.python.createEnvironment.description2%", "media": { - "markdown": "resources/walkthrough/environments-info.md" + "svg": "resources/walkthrough/create-environment.svg", + "altText": "%walkthrough.step.python.createEnvironment.altText%" }, "when": "" }, { - "id": "python.runAndDebug", - "title": "%walkthrough.step.python.runAndDebug.title%", - "description": "%walkthrough.step.python.runAndDebug.description%", + "id": "python.runAndDebug2", + "title": "%walkthrough.step.python.runAndDebug2.title%", + "description": "%walkthrough.step.python.runAndDebug2.description%", "media": { "svg": "resources/walkthrough/rundebug2.svg", "altText": "%walkthrough.step.python.runAndDebug.altText%" @@ -238,7 +229,7 @@ }, { "id": "python.learnMoreWithDS2", - "title": "%walkthrough.step.python.learnMoreWithDS.title%", + "title": "%walkthrough.step.python.learnMoreWithDS2.title%", "description": "%walkthrough.step.python.learnMoreWithDS.description2%", "media": { "altText": "%walkthrough.step.python.learnMoreWithDS.altText%", diff --git a/extensions/positron-python/package.nls.json b/extensions/positron-python/package.nls.json index 127c2b08ac49..f7fe4d97470c 100644 --- a/extensions/positron-python/package.nls.json +++ b/extensions/positron-python/package.nls.json @@ -137,8 +137,8 @@ "Please make sure there is no space between the right bracket and left parenthesis: ]( this is an internal syntax for links" ] }, - "walkthrough.step.python.createEnvironment.title": "Create a Python Environment ", - "walkthrough.step.python.createEnvironment.title2": "Create or select a Python Environment ", + "walkthrough.step.python.createEnvironment.title": "Create a Python Environment", + "walkthrough.step.python.createEnvironment.title2": "Select a Python environment", "walkthrough.step.python.createEnvironment.description": { "message": "Create an environment for your Python project.\n[Create Environment](command:python.createEnvironment)\n**Tip**: Run the ``Python: Create Environment`` command in the [Command Palette](command:workbench.action.showCommands).\n 🔍 Check out our [docs](https://aka.ms/pythonenvs) to learn more.", "comment": [ @@ -148,12 +148,32 @@ "Please make sure there is no space between the right bracket and left parenthesis: ]( this is an internal syntax for links" ] }, - "walkthrough.step.python.createEnvironment.description2": "Create an environment for your Python project or use [Select Python Interpreter](command:python.setInterpreter) to select an existing one.\n[Create Environment](command:python.createEnvironment)\n**Tip**: Run the ``Python: Create Environment`` command in the [Command Palette](command:workbench.action.showCommands).", + "walkthrough.step.python.createEnvironment.description2": { + "message": "[Select a Python interpreter](command:python.setInterpreter) or [create an environment](command:python.createEnvironment) for your Python project.\n[Select Interpreter](command:python.setInterpreter)", + "comment": [ + "{Locked='](command:python.createEnvironment'}", + "{Locked='](command:python.setInterpreter'}", + "Do not translate the 'command:*' part inside of the '(..)'. It is an internal command syntax for VS Code", + "Please make sure there is no space between the right bracket and left parenthesis: ]( this is an internal syntax for links" + ] + }, "walkthrough.step.python.runAndDebug.title": "Run and debug your Python file", - "walkthrough.step.python.runAndDebug.description": "Open your Python file and click on the play button on the top right of the editor, or press F5 when on the file and select \"Python File\" to run with the debugger. \n \n[Learn more](https://code.visualstudio.com/docs/python/python-tutorial#_run-hello-world)", + "walkthrough.step.python.runAndDebug2.title": "Run and debug", + "walkthrough.step.python.runAndDebug2.description": "Click the play button on the top right of the editor, or press F5 when on the file and select \"Python File\" to run with the debugger.", + "walkthrough.step.python.runAndDebug.description": "Open your Python file and click on the play button on the top right of the editor, or press F5 when on the file and select \"Python File\" to run with the debugger. \n \n[Learn more](https://code.visualstudio.com/docs/python/python-tutorial#_run-hello-world)", "walkthrough.step.python.learnMoreWithDS.title": "Explore more resources", + "walkthrough.step.python.learnMoreWithDS2.title": "Keep exploring!", "walkthrough.step.python.learnMoreWithDS.description": { - "message": "🎨 Explore all the features the Python extension has to offer by looking for \"Python\" in the [Command Palette](command:workbench.action.showCommands). \n 📈 Learn more about getting started with [data science](command:workbench.action.openWalkthrough?%7B%22category%22%3A%22ms-python.python%23pythonDataScienceWelcome%22%2C%22step%22%3A%22ms-python.python%23python.createNewNotebook%22%7D) in Python. \n ✨ Take a look at our [Release Notes](https://aka.ms/AA8dxtb) to learn more about the latest features. \n \n[Learn More](https://aka.ms/AA8dqti)", + "message": "🎨 Find all the features the Python extension has to offer by looking for \"Python\" in the [Command Palette](command:workbench.action.showCommands). \n 📈 Learn more about getting started with [data science](command:workbench.action.openWalkthrough?%7B%22category%22%3A%22ms-python.python%23pythonDataScienceWelcome%22%2C%22step%22%3A%22ms-python.python%23python.createNewNotebook%22%7D) in Python. \n ✨ Take a look at our [Release Notes](https://aka.ms/AA8dxtb) to learn more about the latest features. \n \n[Learn More](https://aka.ms/AA8dqti)", + "comment": [ + "{Locked='](command:workbench.action.showCommands'}", + "{Locked='](command:workbench.action.openWalkthrough?%7B%22category%22%3A%22ms-python.python%23pythonDataScienceWelcome%22%2C%22step%22%3A%22ms-python.python%23python.createNewNotebook%22%7D'}", + "Do not translate the 'command:*' part inside of the '(..)'. It is an internal command syntax for VS Code", + "Please make sure there is no space between the right bracket and left parenthesis: ]( this is an internal syntax for links" + ] + }, + "walkthrough.step.python.learnMoreWithDS.description2": { + "message": "🎨 Explore all the features the Python extension has to offer by searching for \"Python\" in the [Command Palette](command:workbench.action.showCommands). \n 📈 Learn more about getting started with [data science](command:workbench.action.openWalkthrough?%7B%22category%22%3A%22ms-python.python%23pythonDataScienceWelcome%22%2C%22step%22%3A%22ms-python.python%23python.createNewNotebook%22%7D) in Python. \n ✨ Take a look at our [Release Notes](https://aka.ms/AA8dxtb) to learn more about the latest features. \n \n[Follow along with the Python Quick Start](https://code.visualstudio.com/docs/python/python-quick-start)", "comment": [ "{Locked='](command:workbench.action.showCommands'}", "{Locked='](command:workbench.action.openWalkthrough?%7B%22category%22%3A%22ms-python.python%23pythonDataScienceWelcome%22%2C%22step%22%3A%22ms-python.python%23python.createNewNotebook%22%7D'}", @@ -161,7 +181,6 @@ "Please make sure there is no space between the right bracket and left parenthesis: ]( this is an internal syntax for links" ] }, - "walkthrough.step.python.learnMoreWithDS.description2": "🎨 Explore all the features the Python extension has to offer by looking for \"Python\" in the [Command Palette](command:workbench.action.showCommands). \n 📈 Learn more about getting started with [data science](command:workbench.action.openWalkthrough?%7B%22category%22%3A%22ms-python.python%23pythonDataScienceWelcome%22%2C%22step%22%3A%22ms-python.python%23python.createNewNotebook%22%7D) in Python. \n ✨ Take a look at our [Release Notes](https://aka.ms/AA8dxtb) to learn more about the latest features. \n \n[Follow along with the Python Tutorial](https://aka.ms/AA8dqti)", "walkthrough.pythonDataScienceWelcome.title": "Get Started with Python for Data Science", "walkthrough.pythonDataScienceWelcome.description": "Your first steps to getting started with a Data Science project with Python!", "walkthrough.step.python.installJupyterExt.title": "Install Jupyter extension",