Updates to walkthrough (microsoft/vscode-python#23107)

- Updating walkthrough based on previous experiment - Updating based on microsoft/vscode-python#22664 Co-authored-by: Eleanor Boyd <[email protected]>
posit-dev · Apr 5, 2024 · 82e8fec · 82e8fec
1 parent 89ac7ed
commit 82e8fec
Show file tree

Hide file tree

Showing 2 changed files with 31 additions and 21 deletions.
diff --git 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
@@ -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,20 +148,39 @@
             "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'}",
             "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": "🎨 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",