Skip to content

Commit 03d1348

Browse files
authored
Merge pull request #3437 from gewarren/get-started
Move two quickstarts to get-started folder
2 parents 4f5f1cd + a80c862 commit 03d1348

24 files changed

+43
-33
lines changed

.openpublishing.redirection.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6941,6 +6941,16 @@
69416941
"source_path": "docs/test/how-to-specify-plot-options-for-graphing-counters.md",
69426942
"redirect_url": "/visualstudio/test/quickstart-create-a-load-test-project",
69436943
"redirect_document_id": false
6944+
},
6945+
{
6946+
"source_path": "docs/ide/quickstart-editor.md",
6947+
"redirect_url": "/visualstudio/get-started/tutorial-editor",
6948+
"redirect_document_id": false
6949+
},
6950+
{
6951+
"source_path": "docs/ide/quickstart-projects-solutions.md",
6952+
"redirect_url": "/visualstudio/get-started/tutorial-projects-solutions",
6953+
"redirect_document_id": false
69446954
}
69456955
]
69466956
}

docs/ide/quickstart-editor.md renamed to docs/get-started/tutorial-editor.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: Introduction to editing
33
ms.date: 11/30/2017
44
ms.prod: visual-studio-dev15
5-
ms.technology: vs-ide-general
6-
ms.topic: quickstart
5+
ms.technology: vs-acquisition
6+
ms.topic: tutorial
77
author: gewarren
88
ms.author: gewarren
99
manager: douge
@@ -30,7 +30,7 @@ Start by creating a new file and adding some code to it.
3030

3131
A new file opens in the editor with the skeleton of a C# class. (Notice that we don't have to create a full Visual Studio project to gain some of the benefits that the code editor offers; all you need is a code file!)
3232

33-
![C# code file in Visual Studio](media/quickstart-editor.png)
33+
![C# code file in Visual Studio](media/tutorial-editor.png)
3434

3535
## Use code snippets
3636

@@ -40,23 +40,23 @@ Visual Studio provides useful *code snippets* that you can use to quickly and ea
4040

4141
A pop-up dialog box appears with information about the `svm` code snippet.
4242

43-
![IntelliSense for code snippet in Visual Studio](media/quickstart-intellisense-snippet.png)
43+
![IntelliSense for code snippet in Visual Studio](media/tutorial-intellisense-snippet.png)
4444

4545
1. Press **Tab** twice to insert the code snippet.
4646

4747
You see the `static void Main()` method signature get added to the file. The [Main()](/dotnet/csharp/programming-guide/main-and-command-args/) method is the entry point for C# applications.
4848

4949
The available code snippets vary for different programming languages. You can look at the available code snippets for your language by choosing **Edit** > **IntelliSense** > **Insert Snippet**, and then choosing your language's folder. For C#, the list looks like this:
5050

51-
![C# code snippet list](media/quickstart-code-snippet-list.png)
51+
![C# code snippet list](media/tutorial-code-snippet-list.png)
5252

5353
The list includes snippets for creating a [class](/dotnet/csharp/programming-guide/classes-and-structs/classes), a [constructor](/dotnet/csharp/programming-guide/classes-and-structs/constructors), a [for](/dotnet/csharp/language-reference/keywords/for) loop, an [if](/dotnet/csharp/language-reference/keywords/if-else) or [switch](/dotnet/csharp/language-reference/keywords/switch) statement, and more.
5454

5555
## Comment out code
5656

57-
The toolbar, which is the row of buttons under the menu bar in Visual Studio, can help make you more productive as you code. For example, you can toggle IntelliSense completion mode ([IntelliSense](using-intellisense.md) is a coding aid that displays a list of matching methods, amongst other things), increase or decrease a line indent, or comment out code that you don't want to compile. In this section, we'll comment out some code.
57+
The toolbar, which is the row of buttons under the menu bar in Visual Studio, can help make you more productive as you code. For example, you can toggle IntelliSense completion mode ([IntelliSense](../ide/using-intellisense.md) is a coding aid that displays a list of matching methods, amongst other things), increase or decrease a line indent, or comment out code that you don't want to compile. In this section, we'll comment out some code.
5858

59-
![Editor toolbar](media/quickstart-editor-toolbar.png)
59+
![Editor toolbar](media/tutorial-editor-toolbar.png)
6060

6161
1. Paste the following code into the `Main()` method body.
6262

@@ -84,15 +84,15 @@ The toolbar, which is the row of buttons under the menu bar in Visual Studio, ca
8484

8585
1. We're not using the `morewords` variable, but we may use it later so we don't want to completely delete it. Instead, let's comment out those lines. Select the entire definition of `morewords` to the closing semi-colon, and then choose the **Comment out the selected lines** button on the toolbar. If you prefer to use the keyboard, press **Ctrl**+**K**, **Ctrl**+**C**.
8686

87-
![Comment out button](media/quickstart-comment-out.png)
87+
![Comment out button](media/tutorial-comment-out.png)
8888

8989
The C# comment characters `//` are added to the beginning of each selected line to comment out the code.
9090
9191
## Collapse code blocks
9292

9393
We don't want to see the empty [constructor](/dotnet/csharp/programming-guide/classes-and-structs/constructors) for `Class1` that was generated, so to unclutter our view of the code, let's collapse it. Choose the small gray box with the minus sign inside it in the margin of the first line of the constructor. Or, if you're a keyboard user, place the cursor anywhere in the constructor code and press **Ctrl**+**M**, **Ctrl**+**M**.
9494

95-
![Outlining collapse button](media/quickstart-collapse.png)
95+
![Outlining collapse button](media/tutorial-collapse.png)
9696

9797
The code block collapses to just the first line, followed by an ellipsis (`...`). To expand the code block again, click the same gray box that now has a plus sign in it, or press **Ctrl**+**M**, **Ctrl**+**M** again. This feature is called [Outlining](../ide/outlining.md) and is especially useful when you're collapsing long methods or entire classes.
9898

@@ -104,7 +104,7 @@ The Visual Studio editor makes it easy to inspect the definition of a type, meth
104104

105105
A pop-up window appears with the definition of the `String` class. You can scroll within the pop-up window, or even peek at the definition of another type from the peeked code.
106106

107-
![Peek definition window](media/quickstart-peek-definition.png)
107+
![Peek definition window](media/tutorial-peek-definition.png)
108108

109109
1. Close the peeked definition window by choosing the small box with an "x" at the top right of the pop-up window.
110110

@@ -120,7 +120,7 @@ The Visual Studio editor makes it easy to inspect the definition of a type, meth
120120

121121
You see IntelliSense show you **Quick Info** about the `query` symbol.
122122

123-
![IntelliSense word completion in Visual Studio](media/quickstart-intellisense-completion-list.png)
123+
![IntelliSense word completion in Visual Studio](media/tutorial-intellisense-completion-list.png)
124124

125125
1. To insert the rest of the word `query` by using IntelliSense's word completion functionality, press **Tab**.
126126

@@ -143,7 +143,7 @@ Nobody gets code right the first time, and one of the things you might have to c
143143

144144
1. Enter the desired name **words**. Notice that the reference to `words` in the query is also automatically renamed. Before you press **Enter**, select the **Include comments** checkbox in the **Rename** pop-up box.
145145

146-
![Rename dialog box](media/quickstart-rename.png)
146+
![Rename dialog box](media/tutorial-rename.png)
147147

148148
1. Press **Enter**.
149149

@@ -152,7 +152,7 @@ Nobody gets code right the first time, and one of the things you might have to c
152152
## Next steps
153153

154154
> [!div class="nextstepaction"]
155-
> [Learn about projects and solutions](../ide/quickstart-projects-solutions.md)
155+
> [Learn about projects and solutions](../get-started/tutorial-projects-solutions.md)
156156
157157
## See also
158158

docs/ide/quickstart-projects-solutions.md renamed to docs/get-started/tutorial-projects-solutions.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: Introduction to projects and solutions
33
ms.date: 12/11/2017
44
ms.prod: visual-studio-dev15
5-
ms.technology: vs-ide-general
6-
ms.topic: quickstart
5+
ms.technology: vs-acquisition
6+
ms.topic: tutorial
77
author: gewarren
88
ms.author: gewarren
99
manager: douge
@@ -37,7 +37,7 @@ We'll start our exploration by creating an empty solution. After you get to know
3737

3838
1. In the left pane, expand **Other Project Types**, then choose **Visual Studio Solutions**. In the center pane, choose the **Blank Solution** template. Name your solution **QuickSolution**, then choose the **OK** button.
3939

40-
![Blank solution template in Visual Studio](media/quickstart-projects-new-solution.png)
40+
![Blank solution template in Visual Studio](media/tutorial-projects-new-solution.png)
4141

4242
The **Start Page** closes, and a solution appears in **Solution Explorer** on the right-hand side of the Visual Studio window. You'll probably use **Solution Explorer** often, to browse the contents of your projects.
4343

@@ -56,7 +56,7 @@ Now let's add our first project to the solution. We'll start with an empty proje
5656
> [!NOTE]
5757
> If you don't see **Visual C#** in the left pane of the dialog box, you need to install the **.NET desktop development** Visual Studio *workload*. Visual Studio uses workload-based installation to only install the components you need for the type of development you do. An easy way to install a new workload is to choose the **Open Visual Studio Installer** link in the bottom left corner of the **Add New Project** dialog box. After Visual Studio Installer launches, choose the **.NET desktop development** workload and then the **Modify** button.
5858
59-
![Open Visual Studio Installer link](media/quickstart-projects-open-installer.png)
59+
![Open Visual Studio Installer link](media/tutorial-projects-open-installer.png)
6060

6161
## Add an item to the project
6262

@@ -110,15 +110,15 @@ Let's add a unit test project to our solution. This time we'll start from a proj
110110

111111
A second project is added to **Solution Explorer**, and a file named *UnitTest1.vb* opens in the editor. *.vb* is the file extension that is given to Visual Basic code files.
112112

113-
![Visual Studio Solution Explorer with two projects](media/quickstart-projects-solution-explorer.png)
113+
![Visual Studio Solution Explorer with two projects](media/tutorial-projects-solution-explorer.png)
114114

115115
## Add a project reference
116116

117117
We're going to use the new unit test project to test our method in the **QuickDate** project, so we need to add a reference to that project. This creates a *build dependency* between the two projects, meaning that when you build the solution, **QuickDate** is built before **QuickTest**.
118118

119119
1. Choose the **References** node in the **QuickTest** project, and from the right-click or context menu, choose **Add Reference**.
120120

121-
![Add Reference menu](media/quickstart-projects-add-reference.png)
121+
![Add Reference menu](media/tutorial-projects-add-reference.png)
122122

123123
The **Reference Manager** dialog box opens.
124124

@@ -152,7 +152,7 @@ We're going to use the new unit test project to test our method in the **QuickDa
152152

153153
The code file should look like this:
154154

155-
![CSharp code](media/quickstart-projects-cs-code.png)
155+
![CSharp code](media/tutorial-projects-cs-code.png)
156156

157157
## Project properties
158158

@@ -162,15 +162,15 @@ The line in the *Calendar.cs* file that contains the <xref:System.Runtime.Compil
162162

163163
The *property pages* for the project open on the **Application** tab. The property pages contain various settings for the project. Notice that the assembly name of the **QuickTest** project is indeed "QuickTest". If you wanted to change it, this is where you'd do that. Then, when you build the test project, the name of the resulting binary file would change from *QuickTest.dll* to whatever you chose.
164164

165-
![Project properties](media/quickstart-projects-properties.png)
165+
![Project properties](media/tutorial-projects-properties.png)
166166

167167
1. Explore some of the other tabs of the project's property pages, such as **Compile** and **Settings**. These tabs are different for different types of projects.
168168

169169
## Next steps
170170

171171
If you want to check that your unit test is working, choose **Test** > **Run** > **All Tests** from the menu bar. A window called **Test Explorer** opens, and you should see that the **TestGetCurrentDate** test passes.
172172

173-
![Test Explorer in Visual Studio showing passed test](media/quickstart-projects-test-explorer.png)
173+
![Test Explorer in Visual Studio showing passed test](media/tutorial-projects-test-explorer.png)
174174

175175
> [!TIP]
176176
> If **Test Explorer** doesn't open automatically, open it by choosing **Test** > **Windows** > **Test Explorer** from the menu bar.

docs/ide/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ Tutorials, videos, and other documentation show you ways to create code and apps
9595
</a>
9696
</li>
9797
<li>
98-
<a href="/visualstudio/ide/quickstart-projects-solutions">
98+
<a href="/visualstudio/get-started/tutorial-projects-solutions">
9999
<div class="cardSize">
100100
<div class="cardPadding">
101101
<div class="card">
@@ -113,7 +113,7 @@ Tutorials, videos, and other documentation show you ways to create code and apps
113113
</a>
114114
</li>
115115
<li>
116-
<a href="/visualstudio/ide/quickstart-editor">
116+
<a href="/visualstudio/get-started/tutorial-editor">
117117
<div class="cardSize">
118118
<div class="cardPadding">
119119
<div class="card">

docs/ide/quickstart-ide-orientation.experimental.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -101,10 +101,10 @@ Should you encounter any problems while you're using Visual Studio, or if you ha
101101
We've looked at just a few of the features of Visual Studio to get acquainted with the user interface. To explore further:
102102

103103
> [!div class="nextstepaction"]
104-
> [Learn about the code editor](../ide/quickstart-editor.md)
104+
> [Learn about the code editor](../get-started/tutorial-editor.md)
105105
106106
> [!div class="nextstepaction"]
107-
> [Learn about projects and solutions](../ide/quickstart-projects-solutions.md)
107+
> [Learn about projects and solutions](../get-started/tutorial-projects-solutions.md)
108108
109109
## See also
110110

docs/ide/quickstart-ide-orientation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -101,10 +101,10 @@ Should you encounter any problems while you're using Visual Studio, or if you ha
101101
We've looked at just a few of the features of Visual Studio to get acquainted with the user interface. To explore further:
102102

103103
> [!div class="nextstepaction"]
104-
> [Learn about the code editor](../ide/quickstart-editor.md)
104+
> [Learn about the code editor](../get-started/tutorial-editor.md)
105105
106106
> [!div class="nextstepaction"]
107-
> [Learn about projects and solutions](../ide/quickstart-projects-solutions.md)
107+
> [Learn about projects and solutions](../get-started/tutorial-projects-solutions.md)
108108
109109
## See also
110110

docs/ide/visual-studio-ide.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ The Visual Studio *integrated development environment* is a creative launching p
2222

2323
This image shows Visual Studio with an open project and several key tool windows you'll likely use:
2424

25-
- [**Solution Explorer**](../ide/solutions-and-projects-in-visual-studio.md) (top right) 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).
25+
- [**Solution Explorer**](../ide/solutions-and-projects-in-visual-studio.md) (top right) lets you view, navigate, and manage your code files. **Solution Explorer** can help organize your code by grouping the files into [solutions and projects](../get-started/tutorial-projects-solutions.md).
2626

2727
- The [editor window](../ide/writing-code-in-the-code-and-text-editor.md) (center), where you'll likely spend a majority of your time, displays file contents. This is where you can edit code or design a user interface such as a window with buttons and text boxes.
2828

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

259259
Explore Visual Studio further by following along with one of these introductory articles:
260260

261-
- Get acquainted with the code editor in [Learn to use the code editor](quickstart-editor.md)
261+
- Get acquainted with the code editor in [Learn to use the code editor](../get-started/tutorial-editor.md)
262262

263-
- Learn how Visual Studio organizes code in [Learn about projects and solutions](quickstart-projects-solutions.md)
263+
- Learn how Visual Studio organizes code in [Learn about projects and solutions](../get-started/tutorial-projects-solutions.md)
264264

265265
If you're ready to dive into more coding, one of the following language-specific quickstarts is a good next step:
266266

docs/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@
66
- name: About Visual Studio 2017
77
href: ide/visual-studio-ide.md
88
- name: About the code editor
9-
href: ide/quickstart-editor.md
9+
href: get-started/tutorial-editor.md
1010
- name: About projects and solutions
11-
href: ide/quickstart-projects-solutions.md
11+
href: get-started/tutorial-projects-solutions.md
1212
- name: More Visual Studio features
1313
href: ide/advanced-feature-overview.md
1414
- name: Installation

0 commit comments

Comments
 (0)