azure functions walkthrough (#3573)

* walkthrough

* create not crete

* replace links with aka.ms links

* blog storage -> blob storage

* add when: false clause

package.json

@@ -386,6 +386,11 @@
                 "command": "azureFunctions.viewProperties",
                 "title": "%azureFunctions.viewProperties%",
                 "category": "Azure Functions"
+            },
+            {
+                "command": "azureFunctions.openWalkthrough",
+                "title": "%azureFunctions.openWalkthrough%",
+                "category": "Azure Functions"
             }
         ],
         "menus": {
@@ -1082,6 +1087,49 @@
                     }
                 }
             }
+        ],
+        "walkthroughs": [
+            {
+                "id": "functionsStart",
+                "title": "%azureFunctions.walkthrough.functionsStart.title%",
+                "description": "%azureFunctions.walkthrough.functionsStart.description%",
+                "when": "false",
+                "steps": [
+                    {
+                        "id": "scenarios",
+                        "title": "%azureFunctions.walkthrough.functionsStart.scenarios.title%",
+                        "completionEvents": [
+                            "onStepSelected"
+                        ],
+                        "description": "%azureFunctions.walkthrough.functionsStart.scenarios.description%",
+                        "media": {
+                            "markdown": "resources/walkthroughs/scenarios.md"
+                        }
+                    },
+                    {
+                        "id": "create",
+                        "title": "%azureFunctions.walkthrough.functionsStart.create.title%",
+                        "completionEvents": [
+                            "onCommand:azureFunctions.createNewProject"
+                        ],
+                        "description": "%azureFunctions.walkthrough.functionsStart.create.description%",
+                        "media": {
+                            "markdown": "resources/walkthroughs/empty.md"
+                        }
+                    },
+                    {
+                        "id": "initialize",
+                        "title": "%azureFunctions.walkthrough.functionsStart.initialize.title%",
+                        "completionEvents": [
+                            "onCommand:azureFunctions.initProjectForVSCode"
+                        ],
+                        "description": "%azureFunctions.walkthrough.functionsStart.initialize.description%",
+                        "media": {
+                            "markdown": "resources/walkthroughs/empty.md"
+                        }
+                    }
+                ]
+            }
         ]
     },
     "scripts": {

package.nls.json

@@ -41,6 +41,7 @@
     "azureFunctions.installOrUpdateFuncCoreTools": "Install or Update Azure Functions Core Tools",
     "azureFunctions.javaBuildTool": "Build tool for Java Functions project",
     "azureFunctions.openInPortal": "Open in Portal",
+    "azureFunctions.openWalkthrough": "Open Azure Functions Extension Walkthrough",
     "azureFunctions.pickProcess": "Pick Process",
     "azureFunctions.pickProcessTimeout": "The timeout (in seconds) to be used when searching for the Azure Functions host process. Since a build is required every time you F5, you may need to adjust this based on how long your build takes.",
     "azureFunctions.postDeployTask": "The name of the task to run after zip deployments.",
@@ -104,5 +105,16 @@
     "azureFunctions.validateFuncCoreTools": "Validate the Azure Functions Core Tools is installed before debugging.",
     "azureFunctions.viewCommitInGitHub": "View Commit in GitHub",
     "azureFunctions.viewDeploymentLogs": "View Deployment Logs",
+    "azureFunctions.viewProperties": "View Properties",
+    "azureFunctions.functionSubpath": "The default subpath to create new functions. Currently, this only applies to Node.js programming model v4+.",
+    "azureFunctions.showNodeProgrammingModel": "Enable preview Node.js programming model",
+    "azureFunctions.walkthrough.functionsStart.title": "Get Started with Azure Functions",
+    "azureFunctions.walkthrough.functionsStart.description": "Learn about Azure Functions and the Azure Functions extension for Visual Studio Code",
+    "azureFunctions.walkthrough.functionsStart.scenarios.title": "Explore common scenarios",
+    "azureFunctions.walkthrough.functionsStart.scenarios.description": "Learn how you can use Azure Functions to build event-driven systems.\n\nIf you're just getting started with Azure Functions, you can [learn about the anatomy of an Azure Functions application](https://aka.ms/functions-getstarted-devguide).",
+    "azureFunctions.walkthrough.functionsStart.create.title": "Create a new Azure Functions project",
+    "azureFunctions.walkthrough.functionsStart.create.description": "If you're just getting started, you will need to create an Azure Functions project. Follow along with the [Visual Studio Code developer guide](https://aka.ms/functions-getstarted-vscode) for step-by-step instructions.\n[Create New Project](command:azureFunctions.createNewProject)",
+    "azureFunctions.walkthrough.functionsStart.initialize.title": "Initialize an existing project",
+    "azureFunctions.walkthrough.functionsStart.initialize.description": "If you created a project using Azure Functions Core Tools, then you will need to initialize your project for use in VS Code. This command adds the required Visual Studio Code project files to an existing Functions project.\n[Initialize Project for Use with VS Code](command:azureFunctions.initProjectForVSCode)",
     "azureFunctions.viewProperties": "View Properties"
 }

resources/walkthroughs/empty.md

@@ -0,0 +1 @@
+<!-- Empty file to allow rendering a walkthrough step without media -->

resources/walkthroughs/scenarios.md

@@ -0,0 +1,7 @@
+| If you want to...           | Then...                                                                                                                                    |
+|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|
+| Build a web API             | Implement an endpoint for your web applications using the [HTTP trigger](https://aka.ms/functions-getstarted-httptrigger)                  |
+| Run scheduled tasks         | Execute code on [pre-defined time intervals](https://aka.ms/functions-getstarted-timertrigger)                                             |
+| Build a serverless workflow | Create an event-driven workflow from a series of functions using [durable functions](https://aka.ms/functions-getstarted-durablefunctions) |
+| Process file uploads        | Run code when a file is uploaded or changed in [blob storage](https://aka.ms/functions-getstarted-blobstorage)                             |
+| Respond to database changes | Run custom logic when a document is created or updated in [Azure Cosmos DB](https://aka.ms/functions-getstarted-cosmosdb)                  |

src/commands/registerCommands.ts

@@ -5,6 +5,7 @@
 
 import { AppSettingsTreeItem, AppSettingTreeItem, registerSiteCommand } from '@microsoft/vscode-azext-azureappservice';
 import { AzExtParentTreeItem, AzExtTreeItem, IActionContext, registerCommand, registerCommandWithTreeNodeUnwrapping, unwrapArgs } from '@microsoft/vscode-azext-utils';
+import { commands } from "vscode";
 import { ext } from '../extensionVariables';
 import { installOrUpdateFuncCoreTools } from '../funcCoreTools/installOrUpdateFuncCoreTools';
 import { uninstallFuncCoreTools } from '../funcCoreTools/uninstallFuncCoreTools';
@@ -84,6 +85,7 @@ export function registerCommands(): void {
     registerCommandWithTreeNodeUnwrapping('azureFunctions.installOrUpdateFuncCoreTools', installOrUpdateFuncCoreTools);
     registerCommandWithTreeNodeUnwrapping('azureFunctions.openFile', openFile);
     registerCommandWithTreeNodeUnwrapping('azureFunctions.openInPortal', openDeploymentInPortal);
+    registerCommand('azureFunctions.openWalkthrough', () => commands.executeCommand('workbench.action.openWalkthrough', 'ms-azuretools.vscode-azurefunctions#functionsStart'));
     registerCommandWithTreeNodeUnwrapping('azureFunctions.pickProcess', pickFuncProcess);
     registerCommandWithTreeNodeUnwrapping('azureFunctions.redeploy', redeployDeployment);
     registerCommandWithTreeNodeUnwrapping('azureFunctions.restartFunctionApp', restartFunctionApp);