Python Walkthrough Updates (#21411)

Updated walkthrough to be put behind an experiment:
- Open Folder tile will allow the walkthrough to persist if there are
remaining steps to be completed in the walkthrough and the user is
opening a folder from an empty workspace
- Added additional environment explanation on the environment media 
- Updated wording on the "Explore more resources" tile

---------

Co-authored-by: Luciana Abud <45497113+luabud@users.noreply.github.com>

Author: cwebster-99

package.json

@@ -173,6 +173,92 @@
                     }
                 ]
             },
+            {
+                "id": "pythonWelcome2",
+                "title": "%walkthrough.pythonWelcome.title%",
+                "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%",
+                        "description": "%walkthrough.step.python.createPythonFile.description%",
+                        "media": {
+                            "svg": "resources/walkthrough/open-folder.svg",
+                            "altText": "%walkthrough.step.python.createPythonFile.altText%"
+                        },
+                        "when": ""
+                    },
+                    {
+                        "id": "python.installPythonWin8",
+                        "title": "%walkthrough.step.python.installPythonWin8.title%",
+                        "description": "%walkthrough.step.python.installPythonWin8.description%",
+                        "media": {
+                            "markdown": "resources/walkthrough/install-python-windows-8.md"
+                        },
+                        "when": "workspacePlatform == windows && showInstallPythonTile"
+                    },
+                    {
+                        "id": "python.installPythonMac",
+                        "title": "%walkthrough.step.python.installPythonMac.title%",
+                        "description": "%walkthrough.step.python.installPythonMac.description%",
+                        "media": {
+                            "markdown": "resources/walkthrough/install-python-macos.md"
+                        },
+                        "when": "workspacePlatform == mac && showInstallPythonTile",
+                        "command": "workbench.action.terminal.new"
+                    },
+                    {
+                        "id": "python.installPythonLinux",
+                        "title": "%walkthrough.step.python.installPythonLinux.title%",
+                        "description": "%walkthrough.step.python.installPythonLinux.description%",
+                        "media": {
+                            "markdown": "resources/walkthrough/install-python-linux.md"
+                        },
+                        "when": "workspacePlatform == linux && showInstallPythonTile",
+                        "command": "workbench.action.terminal.new"
+                    },
+                    {
+                        "id": "python.createEnvironment2",
+                        "title": "%walkthrough.step.python.createEnvironment.title2%",
+                        "description": "%walkthrough.step.python.createEnvironment.description2%",
+                        "media": {
+                            "markdown": "resources/walkthrough/environments-info.md"
+                        },
+                        "when": ""
+                    },
+                    {
+                        "id": "python.runAndDebug",
+                        "title": "%walkthrough.step.python.runAndDebug.title%",
+                        "description": "%walkthrough.step.python.runAndDebug.description%",
+                        "media": {
+                            "svg": "resources/walkthrough/rundebug2.svg",
+                            "altText": "%walkthrough.step.python.runAndDebug.altText%"
+                        },
+                        "when": ""
+                    },
+                    {
+                        "id": "python.learnMoreWithDS2",
+                        "title": "%walkthrough.step.python.learnMoreWithDS.title%",
+                        "description": "%walkthrough.step.python.learnMoreWithDS.description2%",
+                        "media": {
+                            "altText": "%walkthrough.step.python.learnMoreWithDS.altText%",
+                            "svg": "resources/walkthrough/learnmore.svg"
+                        },
+                        "when": ""
+                    }
+                ]
+            },
             {
                 "id": "pythonDataScienceWelcome",
                 "title": "%walkthrough.pythonDataScienceWelcome.title%",
@@ -2030,4 +2116,4 @@
         "webpack-require-from": "^1.8.6",
         "yargs": "^15.3.1"
     }
-}
+}

package.nls.json

@@ -130,7 +130,9 @@
     "walkthrough.pythonWelcome.title": "Get Started with Python Development",
     "walkthrough.pythonWelcome.description": "Your first steps to set up a Python project with all the powerful tools and features that the Python extension has to offer!",
     "walkthrough.step.python.createPythonFile.title": "Create a Python file",
+    "walkthrough.step.python.createPythonFolder.title": "Open a Python project folder",
     "walkthrough.step.python.createPythonFile.description": "[Open](command:toSide:workbench.action.files.openFile) or [create](command:toSide:workbench.action.files.newUntitledFile?%7B%22languageId%22%3A%22python%22%7D) a Python file - make sure to save it as \".py\".\n[Create Python File](command:toSide:workbench.action.files.newUntitledFile?%7B%22languageId%22%3A%22python%22%7D)",
+    "walkthrough.step.python.createPythonFolder.description": "[Open](command:workbench.action.files.openFolder) or create a project folder.\n[Open Project Folder](command:workbench.action.files.openFolder)",
     "walkthrough.step.python.installPythonWin8.title": "Install Python",
     "walkthrough.step.python.installPythonWin8.description": "The Python Extension requires Python to be installed. Install Python [from python.org](https://www.python.org/downloads).\n\n[Install Python](https://www.python.org/downloads)\n",
     "walkthrough.step.python.installPythonMac.title": "Install Python",
@@ -140,11 +142,14 @@
     "walkthrough.step.python.selectInterpreter.title": "Select a Python Interpreter",
     "walkthrough.step.python.selectInterpreter.description": "Choose which Python interpreter/environment you want to use for your Python project.\n[Select Python Interpreter](command:python.setInterpreter)\n**Tip**: Run the ``Python: Select Interpreter`` command in the [Command Palette](command:workbench.action.showCommands).",
     "walkthrough.step.python.createEnvironment.title": "Create a Python Environment ",
+    "walkthrough.step.python.createEnvironment.title2": "Create or select a Python Environment ",
     "walkthrough.step.python.createEnvironment.description": "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.",
+    "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.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.learnMoreWithDS.title": "Explore more resources",
     "walkthrough.step.python.learnMoreWithDS.description": "🎨 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)",
+    "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",
@@ -164,4 +169,4 @@
     "walkthrough.step.python.createNewNotebook.altText": "Creating a new Jupyter notebook",
     "walkthrough.step.python.openInteractiveWindow.altText": "Opening Python interactive window",
     "walkthrough.step.python.dataScienceLearnMore.altText": "Image representing our documentation page and mailing list resources."
-}
+}

resources/walkthrough/environments-info.md

@@ -0,0 +1,10 @@
+## Python Environments
+
+<img src="create-environment.svg" alt="Create Environment Dropdown">
+
+Python virtual environments are considered a best practice in Python development. A virtual environment includes a Python interpreter and any packages you have installed into it, such as numpy or Flask.
+
+After you create a virtual environment using the **Python: Create Environment** command, you can install packages into the environment.
+For example, type `python -m pip install numpy` in an activated terminal to install `numpy` into the environment.
+
+🔍 Check out our [docs](https://aka.ms/pythonenvs) to learn more.