Merge pull request dotnet#2793 from rpetrusha/vs-code

Revised C# Visual Studio Code tutorial for .NET Core 2.0

Author: Ron Petrusha

.openpublishing.redirection.json

@@ -886,6 +886,11 @@
             "source_path": "fsharp/tutorials/getting-started/getting-started-command-line.md",
             "redirect_url": "/dotnet/fsharp/get-started/get-started-command-line",
             "redirect_document_id": true
+        },
+        {        
+            "source_path": "docs/csharp/getting-started/with-visual-studio-code.md",
+            "redirect_url": "/dotnet/core/tutorials/with-visual-studio-code",
+            "redirect_document_id": true
         }
     ]
 }

docs/core/tutorials/index.md

@@ -28,7 +28,7 @@ The following tutorials are available for learning about .NET Core.
 
 ## Building applications with Visual Studio Code
 
-- [Getting Started with C# using Visual Studio Code](../../csharp/getting-started/with-visual-studio-code.md)
+- [Getting Started with C# and Visual Studio Code](with-visual-studio-code.md)
 - [Getting started with .NET Core on macOS](using-on-macos.md)
 
 ## Building applications with Visual Studio for Mac

docs/csharp/getting-started/media/with-visual-studio-code/continue.png renamed to docs/core/tutorials/media/with-visual-studio-code/continue.png

@@ -1,20 +1,20 @@
 ---
-title: Get started with Visual Studio Code - C# Guide
+title: Get started with C# and Visual Studio Code - C# Guide | Microsoft Docs
 description: Learn how to create and debug your first .NET Core application in C# using Visual Studio Code. 
 keywords: C#, Get Started, Acquisition, Install, Visual Studio Code, Cross Platform
 author: kendrahavens
 ms.author: mairaw
-ms.date: 5/02/2017
+ms.date: 8/01/2017
 ms.topic: article
 ms.prod: .net
 ms.technology: devlang-csharp
 ms.devlang: csharp
 ms.assetid: 76c23597-4cf9-467e-8a47-0c3703ce37e7
 ---
 
-# Get Started with Visual Studio Code
+# Get Started with C# and Visual Studio Code
 
-.NET Core gives you a fast and modular platform for creating server applications that run on Windows, Linux, and macOS. Use Visual Studio Code with the C# extension to get a powerful editing experience with full support for C# IntelliSense (smart code completion) and debugging.
+.NET Core gives you a fast and modular platform for creating applications that run on Windows, Linux, and macOS. Use Visual Studio Code with the C# extension to get a powerful editing experience with full support for C# IntelliSense (smart code completion) and debugging.
 
 ## Prerequisites
 
@@ -37,17 +37,19 @@ Let's get started with a simple "Hello World" program on .NET Core:
     * Alternatively, you can select **File** > **Open Folder** from the main menu to open your project folder.
 
 2. Initialize a C# project:
-    * Open the Integrated Terminal from Visual Studio Code by typing <kbd>CTRL</kbd>+<kbd>\`</kbd> (backtick).
+    * Open the Integrated Terminal from Visual Studio Code by typing <kbd>CTRL</kbd>+<kbd>\`</kbd> (backtick). Alternatively, you can select **View** > **Integrated Terminal** from the main menu.
     * In the terminal window, type `dotnet new console`.
     * This creates a `Program.cs` file in your folder with a simple "Hello World" program already written, along with a C# project file named `HelloWorld.csproj`.
 
   ![The dotnet new command](media/with-visual-studio-code/dotnetnew.png)
 
 3. Resolve the build assets:
 
-    * Type `dotnet restore`. Running `dotnet restore` gives you access to the  required .NET Core packages that are needed to build your project.
+    * For **.NET Core 1.1**, type `dotnet restore`. Running `dotnet restore` gives you access to the  required .NET Core packages that are needed to build your project.
 
-  ![The dotnet restore command](media/with-visual-studio-code/dotnetrestore.png)
+   ![The dotnet restore command](media/with-visual-studio-code/dotnetrestore.png)
+
+    * For **.NET Core 2.0**, this step is optional. The `dotnet restore` command executes automatically when a new project is created.
 
 4. Run the "Hello World" program:
 
@@ -83,7 +85,7 @@ You can also watch a short video tutorial for further setup help on [Windows](ht
 
   ![Run and Debug](media/with-visual-studio-code/rundebug.png)
 
-7. Select the green arrow at the top to continue debugging, or press the red square to stop.
+7. Select the green arrow at the top to continue debugging, or select the red square at the top to stop.
 
 > [!TIP] 
 > For more information and troubleshooting tips on .NET Core debugging with OmniSharp in Visual Studio Code, see [Instructions for setting up the .NET Core debugger](https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger.md).

docs/csharp/getting-started/media/with-visual-studio-code/dotnetnew.png renamed to docs/core/tutorials/media/with-visual-studio-code/dotnetnew.png

@@ -28,7 +28,7 @@ The following topics are available:
 
    A class library lets you define types and type members that can be called from another application. This topic lets you create a class library with a single method that determines whether a string begins with an uppercase character. Once you've finished building the library, you can develop a [unit test](testing-library-with-visual-studio.md) to ensure that it works as expected, and then you can make it available to [applications that want to consume it](consuming-library-with-visual-studio.md).
 
-- [Get started with Visual Studio Code](with-visual-studio-code.md)
+- [Get started with C# and Visual Studio Code](../../core/tutorials/with-visual-studio-code.md)
 
    Visual Studio Code is a free code editor optimized for building and debugging modern web and cloud applications. It supports IntelliSense and is available for Linux, macOS, and Windows.
 

docs/csharp/getting-started/media/with-visual-studio-code/dotnetrestore.png renamed to docs/core/tutorials/media/with-visual-studio-code/dotnetrestore.png

@@ -5,6 +5,6 @@
 ## [Building a class library with C# and .NET Core in Visual Studio 2017](library-with-visual-studio.md)
 ### [Testing a class library with .NET Core in Visual Studio 2017](testing-library-with-visual-studio.md)
 ### [Consuming a class library with .NET Core in Visual Studio 2017](consuming-library-with-visual-studio.md)
-## [Getting started with Visual Studio Code](with-visual-studio-code.md)
+## [Getting started with C# and Visual Studio Code](../../core/tutorials/with-visual-studio-code.md)
 <!--## [🔧 Getting started with cross-platform tools](with-cross-platform-tools.md)-->
 <!--## [🔧 Getting started with C# Interactive](with-csharp-interactive.md)-->

docs/csharp/getting-started/media/with-visual-studio-code/dotnetrun.png renamed to docs/core/tutorials/media/with-visual-studio-code/dotnetrun.png

@@ -59,6 +59,7 @@
 ## [macOS Prerequisites](core/macos-prerequisites.md)
 ## [Tutorials](core/tutorials/index.md)
 ### [Building a complete .NET Core solution on Windows, using Visual Studio 2017](core/tutorials/using-on-windows-full-solution.md)
+### [Get Started with C# and Visual Studio Code](core/tutorials/with-visual-studio-code.md)
 ### [Getting started with .NET Core on macOS](core/tutorials/using-on-macos.md)
 ### [Getting started with .NET Core on macOS using Visual Studio for Mac](core/tutorials/using-on-mac-vs.md)
 ### [Building a complete .NET Core solution on macOS using Visual Studio for Mac](core/tutorials/using-on-mac-vs-full-solution.md)