diff --git a/package.json b/package.json index 5a7f11db6210..f47c984833cb 100644 --- a/package.json +++ b/package.json @@ -86,6 +86,7 @@ "onCommand:python.createEnvironment", "onCommand:python.createNewFile", "onWalkthrough:pythonWelcome", + "onWalkthrough:pythonWelcomeWithEnv", "onWalkthrough:pythonWelcomeWithDS", "onWalkthrough:pythonDataScienceWelcome", "workspaceContains:mspythonconfig.json", @@ -177,6 +178,93 @@ } ] }, + { + "id": "pythonWelcomeWithEnv", + "title": "Get started with Python development", + "description": "Your first steps to set up a Python project with all the powerful tools and features that the Python extension has to offer!", + "when": "false", + "steps": [ + { + "id": "python.createPythonFile2", + "title": "Create a Python file", + "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)", + "media": { + "svg": "resources/walkthrough/open-folder.svg", + "altText": "Open a Python file or a folder with a Python project." + }, + "when": "" + }, + { + "id": "python.installPythonWin82", + "title": "Install Python", + "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", + "media": { + "markdown": "resources/walkthrough/install-python-windows-8.md" + }, + "when": "workspacePlatform == windows && showInstallPythonTile" + }, + { + "id": "python.installPythonMac2", + "title": "Install Python", + "description": "The Python Extension requires Python to be installed. Install Python 3 through the terminal.\n[Install Python via Brew](command:python.installPythonOnMac)\n", + "media": { + "markdown": "resources/walkthrough/install-python-macos.md" + }, + "when": "workspacePlatform == mac && showInstallPythonTile", + "command": "workbench.action.terminal.new" + }, + { + "id": "python.installPythonLinux2", + "title": "Install Python", + "description": "The Python Extension requires Python to be installed. Install Python 3 through the terminal.\n[Install Python via terminal](command:python.installPythonOnLinux)\n", + "media": { + "markdown": "resources/walkthrough/install-python-linux.md" + }, + "when": "workspacePlatform == linux && showInstallPythonTile", + "command": "workbench.action.terminal.new" + }, + { + "id": "python.createEnvironment", + "title": "Create a Python Environment ", + "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.", + "media": { + "svg": "resources/walkthrough/create-environment.svg", + "altText": "Creating a Python environment from the Command Palette" + }, + "when": "workspaceFolderCount > 0" + }, + { + "id": "python.selectInterpreter2", + "title": "Select a Python Interpreter", + "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).", + "media": { + "svg": "resources/walkthrough/python-interpreter.svg", + "altText": "Selecting a python interpreter from the status bar" + }, + "when": "workspaceFolderCount == 0" + }, + { + "id": "python.runAndDebug2", + "title": "Run and debug your Python file", + "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)", + "media": { + "svg": "resources/walkthrough/rundebug2.svg", + "altText": "How to run and debug in VS Code with F5 or the play button on the top right." + }, + "when": "" + }, + { + "id": "python.learnMoreWithDS2", + "title": "Explore more resources", + "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)", + "media": { + "altText": "Image representing our documentation page and mailing list resources.", + "svg": "resources/walkthrough/learnmore.svg" + }, + "when": "" + } + ] + }, { "id": "pythonDataScienceWelcome", "title": "Get started with Python for Data Science",