From 474533fc76bb9b4e091f2de6952a7f4bbcf3f92b Mon Sep 17 00:00:00 2001
From: Tim Condon <0xTim@users.noreply.github.com>
Date: Mon, 24 May 2021 10:28:10 +0100
Subject: [PATCH] Make instructions for running on Linux explicit (#602)

---
 4.0/docs/hello-world.md | 40 ++++++++++++++++++++++++++++++----------
 1 file changed, 30 insertions(+), 10 deletions(-)

diff --git a/4.0/docs/hello-world.md b/4.0/docs/hello-world.md
index b5f092ac..5089276a 100644
--- a/4.0/docs/hello-world.md
+++ b/4.0/docs/hello-world.md
@@ -18,22 +18,26 @@ vapor new hello -n
 !!! tip
 	The `-n` flag gives you a bare bones template by automatically answering no to all questions.
 
-Once the command finishes, change into the newly created folder and open Xcode.
+Once the command finishes, change into the newly created folder:
+
 
 ```sh
 cd hello
-open Package.swift
-```
-
-## Xcode Dependencies
-
-You should now have Xcode open. It will automatically begin downloading Swift Package Manager dependencies.
-
-At the top of the window, to the right of the Play and Stop buttons, click on your project name to select the project's Scheme, and select an appropriate run target—most likely, "My Mac".
+``` 
 
 ## Build & Run
 
-Once the Swift Package Manager dependencies have finished downloading, click the play button to build and run your project.
+### Xcode
+
+First, open the project in Xcode:
+
+```sh
+open Package.swift
+```
+
+It will automatically begin downloading Swift Package Manager dependencies. This can take some time the first time you open a project. When dependency resolution is complete Xcode will populate the available schemes. 
+
+At the top of the window, to the right of the Play and Stop buttons, click on your project name to select the project's Scheme, and select an appropriate run target—most likely, "My Mac". Click the play button to build and run your project.
 
 You should see the Console pop up at the bottom of the Xcode window.
 
@@ -41,6 +45,22 @@ You should see the Console pop up at the bottom of the Xcode window.
 [ INFO ] Server starting on http://127.0.0.1:8080
 ```
 
+### Linux
+
+On Linux and other OSes (and even on macOS if you don't want to use Xcode) you can edit the project in your favorite editor of choice, such as Vim or VSCode. See the [Swift Server Guides](https://github.com/swift-server/guides/blob/main/docs/setup-and-ide-alternatives.md) for up to date details on setting up other IDEs.
+
+To build and run your project, in Terminal run:
+
+```sh
+swift run
+```
+
+THat will build and run the project. The first time you run this it will take some time to fetch and resolve the dependencies. Once running you should see the following in your console:
+
+```sh
+[ INFO ] Server starting on http://127.0.0.1:8080
+```
+
 ## Visit Localhost
 
 Open your web browser, and visit <a href="http://localhost:8080/hello" target="_blank">localhost:8080/hello</a> or <a href="http://127.0.0.1:8080" target="_blank">http://127.0.0.1:8080</a>