Add a Get Started with Gitpod walkthrough.

Author: Mike Nikles

extensions/gitpod-remote/package.json

@@ -9,7 +9,7 @@
   "icon": "resources/gitpod.png",
   "repository": {
     "type": "git",
-    "url": "https://github.com/gitpod-io/vscode.git"
+    "url": "https://github.com/gitpod-io/openvscode-server.git"
   },
   "bugs": {
     "url": "https://github.com/gitpod-io/gitpod/issues"

extensions/gitpod-web/package.json

@@ -5,6 +5,14 @@
   "publisher": "gitpod",
   "version": "0.0.1",
   "license": "MIT",
+  "icon": "resources/gitpod.png",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gitpod-io/openvscode-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gitpod-io/gitpod/issues"
+  },
   "engines": {
     "vscode": "^1.58.2"
   },
@@ -430,6 +438,54 @@
         "label": "GitHub"
       }
     ],
+    "walkthroughs": [{
+      "id": "gitpod-getstarted",
+      "title": "Get Started with Gitpod",
+      "description": "Explore what Gitpod is and how to get the most out of it.",
+      "steps": [{
+        "id": "whatisgitpod",
+        "title": "What is Gitpod?",
+        "description": "",
+        "media": {
+          "markdown": "resources/walkthroughs/getstarted/what-is-gitpod.md"
+        }
+      }, {
+        "id": "prebuilds",
+        "title": "Prebuilds do the heavy lifting",
+        "description": "",
+        "media": {
+          "markdown": "resources/walkthroughs/getstarted/prebuilds.md"
+        }
+      }, {
+        "id": "workspaces",
+        "title": "A new workspace per task",
+        "description": "",
+        "media": {
+          "markdown": "resources/walkthroughs/getstarted/workspaces.md"
+        }
+      }, {
+        "id": "terminal",
+        "title": "Full access to a terminal",
+        "description": "",
+        "media": {
+          "markdown": "resources/walkthroughs/getstarted/terminal.md"
+        }
+      }, {
+        "id": "ports",
+        "title": "Open ports",
+        "description": "",
+        "media": {
+          "markdown": "resources/walkthroughs/getstarted/ports.md"
+        }
+      }, {
+        "id": "vscodedesktopsupport",
+        "title": "VS Code desktop support",
+        "description": "",
+        "media": {
+          "markdown": "resources/walkthroughs/getstarted/vscodedesktopsupport.md"
+        }
+      }]
+    }],
     "configuration": {
       "title": "Gitpod",
       "properties": {

extensions/gitpod-web/resources/gitpod.png

@@ -0,0 +1,11 @@
+# Ports
+
+If your application listens on any port, e.g. a web application, Gitpod provides a URL for you to access your application.
+
+A list of ports is available in the "Remote Explorer" panel on the left-hand side. [Click here to open the panel.](command:gitpod.ports.reveal)
+
+_Note_: To get back to the list of files in your project, click the "Explorer" icon on the left-hand side.
+
+## Documentation
+
+To learn more about ports and how to configure them, please [refer to the documentation](https://www.gitpod.io/docs/config-ports).

extensions/gitpod-web/resources/walkthroughs/getstarted/ports.md

@@ -0,0 +1,12 @@
+# Prebuilds
+
+Download & install dependencies, run build scripts, you name it - tell Gitpod which tasks to run and it takes care of them **before** you start a new developer environment so you don’t have to wait for any of that.
+
+When new code is pushed to the repository, Gitpod automatically prepares a new workspace based on the latest code.
+
+By the time you start your next workspace, everything is installed, compiled and ready for you to write code.
+
+## Documentation
+
+To learn more and how to enable prebuilds for your project, please [refer to the documentation](https://www.gitpod.io/docs/prebuilds).
+

extensions/gitpod-web/resources/walkthroughs/getstarted/prebuilds.md

@@ -0,0 +1,17 @@
+# The terminal
+
+Gitpod is more than just an editor - it's everything you need to develop, test & debug your application.
+
+With that, you also have access to a terminal, including Docker support.
+
+Let's open a new terminal and run the following command in the terminal:
+
+```bash
+docker run hello-world
+```
+
+Alternatively, [click here](command:gitpod.welcome.createTerminalAndRunDockerCommand) to perform the above automatically.
+
+Just like you used the `hello-world` Docker image, you can containerize your own application right on Gitpod.
+
+To exit a terminal, type `exit` and hit Enter.

extensions/gitpod-web/resources/walkthroughs/getstarted/terminal.md

@@ -0,0 +1,11 @@
+# VS Code desktop support
+
+If you like the idea of ephemeral workspaces, but prefer to develop code in your local VS Code, we've got you covered.
+
+Depending on the version of VS Code you have installed locally, use one of the following links to start your VS Code and connect to the currently running workspace:
+* [Open in VS Code](command:gitpod.openInStable)
+* [Open in VS Code Insiders](command:gitpod.openInInsiders)
+
+## Documentation
+
+To learn more about VS Code desktop support, please [refer to the documentation](https://www.gitpod.io/docs/develop/vscode-desktop-support).

extensions/gitpod-web/resources/walkthroughs/getstarted/vscodedesktopsupport.md

@@ -0,0 +1,37 @@
+# What is Gitpod?
+
+With Gitpod, you spin up fresh, automated dev environments for each task, in the cloud, in seconds.
+
+- Develop a new feature? Start a new workspace.
+- Review a pull request? Start a new workspace.
+- Fix a bug in production? Start a new workspace.
+
+You can even run multiple workspaces in parallel and they are 100% isolated from each other.
+
+## User interface
+
+As you notice, Gitpod looks & feels like VS Code - except it runs in a browser. On Gitpod, you can install extensions, apply themes and use a terminal just as you're used to from your local computer.
+
+## Features
+
+Use the steps on the left side to learn more about the following features:
+
+* Prebuilds
+* Workspaces
+* The terminal
+* Ports
+* VS Code desktop support
+
+## Browser extension
+
+To be most productive with Gitpod, it is best if you [install the browser extension](https://www.gitpod.io/docs/browser-extension). It will add a convenient "Gitpod" button when you look at your repo, an issue or a pull request.
+
+The most productive way to use Gitpod is by installing its browser extension.
+
+## Documentation
+
+To learn more about Gitpod, how to customize it and about best practices, please [check out the documentation](https://www.gitpod.io/docs).
+
+## Community
+
+Come [join us in our chat](https://www.gitpod.io/chat) to learn from others and share what you're up to.

extensions/gitpod-web/resources/walkthroughs/getstarted/what-is-gitpod.md

@@ -0,0 +1,23 @@
+# Workspaces
+
+When you work with Gitpod, your goal is to open as many workspaces as possible ;-). To be more specific, you want to open a new workspace for each task you work on. We call this ephemeral workspaces.
+
+## Benefits of ephemeral workspaces
+
+### Latest code
+
+Each new workspace contains the latest code. There's no need for you to take care of that.
+
+As an added bonus, if you open a Gitpod workspace from an issue URL, Gitpod automatically creates a branch for you! All you need to do is write the code, commit & push.
+
+### Latest dependencies
+
+Each new workspace also has the most up-to-date versions of app & operating system dependencies. Another thing you don't have to worry about.
+
+### Work in parallel
+
+Say you're working on a feature and a team member asks you to review their pull request. Start a new workspace, review the code, close the workspace - and you're back in your feature environment where you continue to work.
+
+## Documentation
+
+To learn more about workspaces, please [refer to the documentation](https://www.gitpod.io/docs/workspaces).

extensions/gitpod-web/resources/walkthroughs/getstarted/workspaces.md

@@ -38,6 +38,7 @@ export async function activate(context: vscode.ExtensionContext) {
 			location: parentTerminal ? { parentTerminal } : vscode.TerminalLocation.Panel
 		});
 	});
+	registerWelcomeWalkthroughCommands(gitpodContext);
 
 	const codeServer = new GitpodCodeServer();
 	registerCLI(codeServer, gitpodContext);
@@ -754,6 +755,14 @@ export function registerPorts(context: GitpodExtensionContext): void {
 	}));
 }
 
+export function registerWelcomeWalkthroughCommands(context: GitpodExtensionContext): void {
+	context.subscriptions.push(vscode.commands.registerCommand('gitpod.welcome.createTerminalAndRunDockerCommand', () => {
+		const terminal = vscode.window.createTerminal('Welcome');
+		terminal.show();
+		terminal.sendText('docker run hello-world');
+	}));
+}
+
 export function registerCLI(codeServer: GitpodCodeServer, context: GitpodExtensionContext): void {
 	const ipcHookCli = context.ipcHookCli;
 	if (context.ipcHookCli) {