Skip to content

Commit 9573bc2

Browse files
committed
de-jargonize VS IDE overview
1 parent f534df3 commit 9573bc2

File tree

1 file changed

+47
-31
lines changed

1 file changed

+47
-31
lines changed

docs/ide/visual-studio-ide.md

Lines changed: 47 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -14,72 +14,90 @@ manager: douge
1414
ms.workload:
1515
- "multiple"
1616
---
17-
# Visual Studio IDE overview
17+
# Visual Studio overview
1818

19-
The Visual Studio interactive development environment (IDE) is a creative launching pad that you can use to view and edit code, and then debug, build, and publish an app.
19+
The Visual Studio *interactive development environment* is a creative launching pad that you can use to edit, debug, and build code, and then publish an app. An interactive development environment (IDE) is a feature-rich program that can be used for many aspects of software development. Over and above the standard editor and debugger that most IDEs provide, Visual Studio includes compilers, code completion tools, graphical designers, and many more features to ease the software development process.
2020

2121
Visual Studio is available for Windows and Mac. [Visual Studio for Mac](/visualstudio/mac/) has many of the same features as Visual Studio 2017, and is optimized for developing cross-platform and mobile apps.
2222

23-
This article focuses on Visual Studio 2017 for Windows. It introduces you to the basic features of the IDE. We'll walk through some things you can do with Visual Studio, including creating a simple project, using IntelliSense as a coding aid, and debugging an app to see the value of a variable during the program's execution. We'll also take a tour of the various tool windows.
23+
This article focuses on Visual Studio 2017 for Windows. It introduces you to the basic features of the IDE. We'll walk through some things you can do with Visual Studio, including creating a simple project, using [IntelliSense](using-intellisense.md) as a coding aid, and debugging an app to see the value of a variable during the program's execution. We'll also take a tour of the various tool windows.
2424

2525
## Install the Visual Studio IDE
2626

2727
To get started, [download Visual Studio 2017](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) and install it on your system.
2828

29-
The modular installer enables you to choose and install *workloads*, which are groups of features needed for the programming language or platform you prefer. To follow the steps for [creating a program](#create-a-program), be sure to select the **.NET Core cross-platform development** workload during installation. The quickstart topics, such as [Get started with C++ in Visual Studio](getting-started-with-cpp-in-visual-studio.md), contain instructions for installing other workloads.
29+
The modular installer enables you to choose and install *workloads*, which are groups of features needed for the programming language or platform you prefer. To follow the steps for [creating a program](#create-a-program), be sure to select the **.NET Core cross-platform development** workload during installation. The quickstart topics, such as [Get started with C++](getting-started-with-cpp-in-visual-studio.md) and [Create a Python web app](quickstart-python.md), are a great next step, and contain instructions for installing other workloads.
3030

3131
![Visual Studio Installer](../ide/media/overview-net-core-workload.png)
3232

33-
When you start Visual Studio for the first time, you can optionally sign in using your Microsoft account, or your work or school account.
33+
When you start Visual Studio for the first time, you can optionally [sign in](signing-in-to-visual-studio.md) using your Microsoft account, or your work or school account.
3434

3535
## Tour of the IDE
3636

3737
To give you a high-level visual overview of Visual Studio, the following image shows Visual Studio with an open project along with several key tool windows you will most likely use:
3838

3939
![The Visual Studio IDE](../ide/media/visualstudioide.png)
4040

41-
- [Solution Explorer](../ide/solutions-and-projects-in-visual-studio.md) lets you view, navigate, and manage your code files. Solution Explorer can help organize your code by grouping the files into solutions and projects.
41+
- [Solution Explorer](../ide/solutions-and-projects-in-visual-studio.md) lets you view, navigate, and manage your code files. **Solution Explorer** can help organize your code by grouping the files into [solutions and projects](quickstart-projects-solutions.md).
4242

43-
- The [editor](../ide/writing-code-in-the-code-and-text-editor.md) window, where you'll likely spend a majority of your time, shows your code and enables you to edit source code and design a UI.
43+
- The [editor window](../ide/writing-code-in-the-code-and-text-editor.md), where you'll likely spend a majority of your time, shows your code and enables you to edit source code and design a UI.
4444

45-
- The [Output window](../ide/reference/output-window.md) is where Visual Studio sends its notifications, such as debugging and error messages, compiler warnings, publishing status messages, and more. Each message source has its own tab.
45+
- The [Output window](../ide/reference/output-window.md) is where Visual Studio sends notifications such as debugging and error messages, compiler warnings, publishing status messages, and more. Each message source has its own tab.
4646

47-
- [Team Explorer (VSTS)](/vsts/user-guide/work-team-explorer) lets you track work items and share code with others using version control technologies such as [Git](https://git-scm.com/) and [Team Foundation Version Control (TFVC)](/vsts/tfvc/overview).
47+
- [Team Explorer](/vsts/user-guide/work-team-explorer) lets you track work items and share code with others using version control technologies such as [Git](https://git-scm.com/) and [Team Foundation Version Control (TFVC)](/vsts/tfvc/overview).
4848

49-
Following are some other popular productivity features in Visual Studio:
49+
### Popular productivity features
5050

51-
- [Refactoring](../ide/refactoring-in-visual-studio.md) includes operations such as intelligent renaming of variables, moving selected lines of code into a separate function, moving code to other locations, reordering function parameters, and more.
51+
Some of the popular features in Visual Studio that help you to be more productive as you develop software include:
5252

53-
![Refactoring](../ide/media/VSIDE_refactor.png)
53+
- [Refactoring](../ide/refactoring-in-visual-studio.md)
5454

55-
- [IntelliSense](../ide/using-intellisense.md) is an umbrella term for a set of popular features that display type information about your code directly in the editor and, in some cases, write small bits of code for you. It's like having basic documentation inline in the editor, which saves you from having to look up type information in a separate help window. IntelliSense features vary by language. For more information, see [C# IntelliSense](../ide/visual-csharp-intellisense.md), [Visual C++ IntelliSense](../ide/visual-cpp-intellisense.md), [JavaScript IntelliSense](../ide/javascript-intellisense.md), and [Visual Basic IntelliSense](../ide/visual-basic-specific-intellisense.md). The following illustration shows some IntelliSense features at work:
55+
Refactoring includes operations such as intelligent renaming of variables, extracting one or more lines of code into a new method, changing the order of method parameters, and more.
56+
57+
![Refactoring in Visual Studio](../ide/media/VSIDE_refactor.png)
58+
59+
- [IntelliSense](../ide/using-intellisense.md)
60+
61+
IntelliSense is a term for a set of features that display information about your code directly in the editor and, in some cases, write small bits of code for you. It's like having basic documentation inline in the editor, which saves you from having to look up type information elsewhere. IntelliSense features vary by language. For more information, see [C# IntelliSense](../ide/visual-csharp-intellisense.md), [Visual C++ IntelliSense](../ide/visual-cpp-intellisense.md), [JavaScript IntelliSense](../ide/javascript-intellisense.md), and [Visual Basic IntelliSense](../ide/visual-basic-specific-intellisense.md). The following illustration shows some IntelliSense features at work:
5662

5763
![Visual Studio Member List](../ide/media/vs2017_Intellisense.png)
5864

59-
- The [Quick Launch](../ide/reference/quick-launch-environment-options-dialog-box.md) search box is a great way to rapidly find what you need in Visual Studio. Just start typing in the name of whatever you are looking for, and Visual Studio lists results that take you exactly where you want to go. **Quick Launch** also shows links that start **Visual Studio Installer** for any workload or individual component.
65+
- [Quick Launch](../ide/reference/quick-launch-environment-options-dialog-box.md)
66+
67+
Visual Studio can seem overwhelming at times with so many menus, options, and properties. The **Quick Launch** search box is a great way to rapidly find what you need in Visual Studio. When you start typing in the name of something you're looking for, Visual Studio lists results that take you exactly where you need to go. If you need to add functionality to Visual Studio, for example to add support for an additional programming language, **Quick Launch** provides results that open Visual Studio Installer to install a workload or individual component.
6068

61-
![Quick Launch search box](../ide/media/VSIDE_Tour_QuickLaunch.png)
69+
![Quick Launch search box in Visual Studio](../ide/media/VSIDE_Tour_QuickLaunch.png)
6270

63-
- **Squiggles** are wavy underlines that alert you to errors or potential problems in your code in real time as you type. This enables you to fix them immediately without waiting for the error to be discovered during compilation or run time. If you hover over the squiggle, you see additional information about the error. A light bulb may also appear in the left margin with actions to fix the error. For more information, see [Quick Actions](../ide/quick-actions.md).
71+
- Squiggles and [Quick Actions](../ide/quick-actions.md)
6472

65-
![Squiggles](../ide/media/vs2017_squiggle.png)
73+
Squiggles are wavy underlines that alert you to errors or potential problems in your code in real time as you type. These visual clues enable you to fix problems immediately without waiting for the error to be discovered during compilation or at run time. If you hover over a squiggle, you see additional information about the error. A light bulb may also appear in the left margin with actions, known as Quick Actions, to fix the error.
6674

67-
- The [Call Hierarchy](../ide/reference/call-hierarchy.md) window can be opened on the text editor context menu to show the methods that call, and are called by, the method under the caret (insertion point).
75+
![Squiggles in Visual Studio](../ide/media/vs2017_squiggle.png)
76+
77+
- [Call Hierarchy](../ide/reference/call-hierarchy.md)
78+
79+
The **Call Hierarchy** window shows the methods that call a selected method. This can be useful information when you're thinking about changing or removing the method, or when you're trying to track down a bug.
6880

6981
![Call Hierarchy window](../ide/media/VSIDE_call_hierarchy.png)
7082

71-
- [CodeLens](../ide/find-code-changes-and-other-history-with-codelens.md) enables you to find references and changes to your code, linked bugs, work items, code reviews, and unit tests, all without leaving the editor.
83+
- [CodeLens](../ide/find-code-changes-and-other-history-with-codelens.md)
7284

73-
![CodeLens](../ide/media/codelensoverview.png)
85+
CodeLens helps you find references to your code, changes to your code, linked bugs, work items, code reviews, and unit tests, all without leaving the editor.
7486

75-
- The [Peek to Definition](../ide/how-to-view-and-edit-code-by-using-peek-definition-alt-plus-f12.md) window shows a method or type definition inline, without navigating away from your current context.
87+
![CodeLens](../ide/media/codelensoverview.png)
7688

77-
![Peek to Definition](../ide/media/VSIDE_peek_definition.png)
89+
- [Go To Definition](../ide/go-to-and-peek-definition.md)
7890

79-
- The [Go To Definition](../ide/go-to-and-peek-definition.md) context menu option takes you directly to the place where the function or object is defined. Other navigation commands are also available by right-clicking in the editor.
91+
The Go To Definition feature takes you directly to the location where a function or type is defined.
8092

8193
![Go to Definition](../ide/media/VSIDE_go_to_definition.png)
8294

95+
- [Peek To Definition](../ide/how-to-view-and-edit-code-by-using-peek-definition-alt-plus-f12.md)
96+
97+
The **Peek Definition** window shows the definition of a method or type without actually opening a separate file.
98+
99+
![Peek to Definition](../ide/media/VSIDE_peek_definition.png)
100+
83101
## Create a program
84102

85103
Let's dive in and create a new, simple program.
@@ -95,15 +113,13 @@ Let's dive in and create a new, simple program.
95113
Visual Studio creates the project. It's a simple "Hello World" application that calls the <xref:System.Console.WriteLine?displayProperty=nameWithType> method to display the literal string "Hello World!" in the console window.
96114

97115
> [!NOTE]
98-
> If you don't see the **.NET Core** category, you need to install the **.NET Core cross-platform development** workload. To do this, choose the **Open Visual Studio Installer** link on the bottom left of the **New Project** dialog. After **Visual Studio Installer** opens, scroll down and select the **.NET Core cross-platform development** workload, and then select **Modify**.
116+
> If you don't see the **.NET Core** category, you need to install the **.NET Core cross-platform development** workload. To do this, choose the **Open Visual Studio Installer** link on the bottom left of the **New Project** dialog. After Visual Studio Installer opens, scroll down and select the **.NET Core cross-platform development** workload, and then select **Modify**.
99117
100118
Shortly, you should see something like the following:
101119

102120
![Visual Studio IDE](../ide/media/overview-ide-console-app.png)
103121

104-
The C# code for your application is shown in the editor window, which takes up most of the space. Notice that the text is automatically colorized to indicate different aspects of the code, such as keywords and types. In addition, small, vertical dashed lines in the code indicate which braces match one another, and line numbers help you locate code later. You can choose the small, boxed minus signs to collapse or expand code. This code outlining feature lets you hide code you don't need, helping to minimize onscreen clutter.
105-
106-
The project files are listed on the right side in a window called **Solution Explorer**.
122+
The C# code for your application is shown in the editor window, which takes up most of the space. Notice that the text is automatically colorized to indicate different parts of the code, such as keywords and types. In addition, small, vertical dashed lines in the code indicate which braces match one another, and line numbers help you locate code later. You can choose the small, boxed minus signs to collapse or expand blocks of code. This code outlining feature lets you hide code you don't need, helping to minimize onscreen clutter. The project files are listed on the right side in a window called **Solution Explorer**.
107123

108124
![Visual Studio IDE with red boxes](../ide/media/overview-ide-console-app-red-boxes.png)
109125

@@ -152,7 +168,7 @@ First, let's rename the `name` variable:
152168

153169
1. Double-click the `name` variable to select it.
154170

155-
1. Type in the new name for the variable, `username`.
171+
1. Type in the new name for the variable, **username**.
156172

157173
Notice that a gray box appears around the variable, and a light bulb appears in the margin.
158174

@@ -200,7 +216,7 @@ First, let's rename the `name` variable:
200216

201217
## Debug code
202218

203-
When you write code, you need to run it and test it for bugs. Visual Studio's debugging system lets you step through code one statement at a time and inspect variables as you go. You can set breakpoints that are only hit when a specified condition is true. You can monitor the values of variables as the code runs, and more.
219+
When you write code, you need to run it and test it for bugs. Visual Studio's debugging system lets you step through code one statement at a time and inspect variables as you go. You can set *breakpoints* that stop execution of the code at a particular line. You can observe how the value of a variable changes as the code runs, and more.
204220

205221
Let's set a breakpoint to see the value of the `username` variable while the program is "in flight".
206222

@@ -226,7 +242,7 @@ To get more details about debugging in Visual Studio, see [Debugger feature tour
226242

227243
## Customize Visual Studio
228244

229-
You can personalize the IDE, including changing the default color theme. To change to the **Dark** theme:
245+
You can personalize the Visual Studio user interface, including change the default color theme. To change to the **Dark** theme:
230246

231247
1. On the menu bar, choose **Tools** > **Options** to open the **Options** dialog.
232248

@@ -242,7 +258,7 @@ To learn about other ways you can personalize the IDE, see [Personalize Visual S
242258

243259
Do you want to create an app for an Android or iOS phone? How about a 3D game, or a cloud-enabled app? To learn about these and other features of Visual Studio, see [Features of Visual Studio 2017](../ide/advanced-feature-overview.md).
244260

245-
If you're just ready to get started coding now, choose one of the Quickstart topics from the table of contents, such as [Create your first ASP.NET Core web app](quickstart-aspnet-core.md).
261+
If you just want to get started coding now, choose one of the Quickstart topics from the table of contents, such as [Create your first ASP.NET Core web app](quickstart-aspnet-core.md).
246262

247263
You can also check out the free Visual Studio courses available on [Microsoft Virtual Academy](https://mva.microsoft.com/product-training/visual-studio-courses#!index=2&lang=1033).
248264

0 commit comments

Comments
 (0)