Skip to content

Commit 9e61ced

Browse files
committed
Update setup overview
1 parent 5f6ff76 commit 9e61ced

File tree

1 file changed

+37
-36
lines changed

1 file changed

+37
-36
lines changed

docs/setup/setup-overview.md

Lines changed: 37 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -10,61 +10,62 @@ MetaSocialImage: images/quicksetup/quick-setup-social.png
1010
---
1111
# Setting up Visual Studio Code
1212

13-
Getting up and running with Visual Studio Code is quick and easy. It is a small download so you can install in a matter of minutes and give VS Code a try.
13+
VS Code is a free code editor, which runs on the macOS, Linux, and Windows operating systems. Getting up and running with Visual Studio Code is quick and easy. It is a small download so you can install in a matter of minutes and give VS Code a try.
1414

15-
## Cross platform
15+
VS Code is lightweight and should run on most available hardware and platform versions. You can review the [System Requirements](/docs/supporting/requirements.md) to check if your computer configuration is supported.
1616

17-
VS Code is a free code editor, which runs on the macOS, Linux, and Windows operating systems.
17+
## Set up VS Code for your platform
1818

19-
Follow the platform-specific guides below:
19+
1. Download and install Visual Studio Code for your platform
2020

21-
* [macOS](/docs/setup/mac.md)
22-
* [Linux](/docs/setup/linux.md)
23-
* [Windows](/docs/setup/windows.md)
21+
* [macOS](/docs/setup/mac.md)
22+
* [Linux](/docs/setup/linux.md)
23+
* [Windows](/docs/setup/windows.md)
2424

25-
VS Code is lightweight and should run on most available hardware and platform versions. You can review the [System Requirements](/docs/supporting/requirements.md) to check if your computer configuration is supported.
25+
> [!NOTE]
26+
> VS Code ships monthly releases and supports [auto-update](#update-cadence) when a new release is available.
2627
27-
## Update cadence
28+
1. [Install additional components](/docs/setup/additional-components.md)
2829

29-
VS Code releases a new version [each month](/updates) with new features and important bug fixes. Most platforms support auto updating and you will be prompted to install the new release when it becomes available. You can also manually check for updates by running **Help** > **Check for Updates** on Linux and Windows or running **Code** > **Check for Updates** on macOS.
30+
Install Git, Node.js, TypeScript, language runtimes, and more.
3031

31-
>Note: You can [disable auto-update](/docs/supporting/faq.md#how-do-i-opt-out-of-vs-code-autoupdates) if you prefer to update VS Code on your own schedule.
32+
1. [Install VS Code extensions from the Visual Studio Marketplace](https://marketplace.visualstudio.com/VSCode)
3233

33-
## Insiders nightly build
34+
Customize VS Code with themes, formatters, language extensions and debuggers for your favorite languages, and more.
3435

35-
If you'd like to try our nightly builds to see new features early or verify bug fixes, you can install our [Insiders build](/insiders). The Insiders build installs side-by-side with the monthly Stable build and you can freely work with either on the same machine. The Insiders build is the same one the VS Code development team uses on a daily basis and we really appreciate people trying out new features and providing feedback.
36+
1. [Set up AI-assisted coding with GitHub Copilot](/docs/copilot/setup-simplified.md)
3637

37-
## Portable mode
38+
> [!TIP]
39+
> If you don't yet have a Copilot subscription, you can use Copilot for free by signing up for the [Copilot Free plan](https://github.com/github-copilot/signup) and get a monthly limit of completions and chat interactions.
3840
39-
Visual Studio Code supports [Portable mode](https://en.wikipedia.org/wiki/Portable_application) installation. This mode enables all data created and maintained by VS Code to live near itself, so it can be moved around across environments, for example, on a USB drive. See the [VS Code Portable Mode](/docs/editor/portable.md) documentation for details.
41+
1. [Get started with the VS Code tutorial](/docs/getstarted/getting-started.md)
42+
43+
Discover the user interface and key features of VS Code.
4044

41-
## Additional components
45+
## Update cadence
4246

43-
VS Code is an editor, first and foremost, and prides itself on a small footprint. Unlike traditional IDEs that tend to include everything but the kitchen sink, you can tune your installation to the development technologies you care about. Be sure to read the [Additional Components](/docs/setup/additional-components.md) topic after reading the platform guides to learn about customizing your VS Code installation.
47+
VS Code releases a new version [each month](/updates) with new features and important bug fixes. Most platforms support auto updating and you are prompted to install the new release when it becomes available.
4448

45-
## Extensions
49+
You can also manually check for updates by running **Help** > **Check for Updates** on Linux and Windows, or running **Code** > **Check for Updates** on macOS.
4650

47-
VS Code [extensions](/docs/editor/extension-marketplace.md) let third parties add support for additional:
51+
> [!NOTE]
52+
> You can [disable auto-update](/docs/supporting/faq.md#how-do-i-opt-out-of-vs-code-autoupdates) if you prefer to update VS Code on your own schedule.
4853
49-
* Languages - [C++](/docs/languages/cpp.md), [C#](/docs/languages/csharp.md), [Go](/docs/languages/go.md), [Java](/docs/languages/java.md), [Python](/docs/languages/python.md)
50-
* Tools - [ESLint](https://marketplace.visualstudio.com/items/dbaeumer.vscode-eslint), [JSHint](https://marketplace.visualstudio.com/items/dbaeumer.jshint) , [PowerShell](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell)
51-
* Debuggers - [PHP XDebug](https://marketplace.visualstudio.com/items?itemName=xdebug.php-debug).
52-
* Keymaps - [Vim](https://marketplace.visualstudio.com/items?itemName=vscodevim.vim), [Sublime Text](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings), [IntelliJ](https://marketplace.visualstudio.com/items?itemName=k--kato.intellij-idea-keybindings), [Emacs](https://marketplace.visualstudio.com/items?itemName=hiro-sun.vscode-emacs), [Atom](https://marketplace.visualstudio.com/items?itemName=ms-vscode.atom-keybindings), [Brackets](https://marketplace.visualstudio.com/items?itemName=ms-vscode.brackets-keybindings), [Visual Studio](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vs-keybindings), [Eclipse](https://marketplace.visualstudio.com/items?itemName=alphabotsec.vscode-eclipse-keybindings)
54+
## Insiders nightly build
5355

54-
Extensions integrate into VS Code's UI, commands, and task running systems so you'll find it easy to work with different technologies through VS Code's shared interface. Check out the VS Code extension [Marketplace](https://marketplace.visualstudio.com/vscode) to see what's available.
56+
If you'd like to try our nightly builds to see new features early or verify bug fixes, you can install our [Insiders build](/insiders). The Insiders build installs side-by-side with the monthly Stable build and you can freely work with either on the same machine. The Insiders build is the same one the VS Code development team uses on a daily basis and we really appreciate people trying out new features and providing feedback.
5557

56-
## Next steps
58+
## Portable mode
59+
60+
Visual Studio Code supports [Portable mode](https://en.wikipedia.org/wiki/Portable_application) installation. This mode enables all data created and maintained by VS Code to live near itself, so it can be moved around across environments, for example, on a USB drive. See the [VS Code Portable Mode](/docs/editor/portable.md) documentation for details.
5761

58-
Once you have installed and set up VS Code, these topics will help you learn more about VS Code:
62+
## Next steps
5963

60-
* [Additional Components](/docs/setup/additional-components.md) - Learn how to install Git, Node.js, TypeScript, and tools like Yeoman.
61-
* [User Interface](/docs/getstarted/userinterface.md) - A quick orientation to VS Code.
62-
* [Basic Editing](/docs/editor/codebasics.md) - Learn about the powerful VS Code editor.
63-
* [Code Navigation](/docs/editor/editingevolved.md) - Move quickly through your source code.
64-
* [Debugging](/docs/editor/debugging.md) - Debug your source code directly in the VS Code editor.
65-
* [Proxy Server Support](/docs/setup/network.md) - Configure your proxy settings.
64+
Once you have installed VS Code, these topics will help you learn more about it:
6665

67-
If you'd like to get something running quickly, try the [Node.js tutorial](/docs/nodejs/nodejs-tutorial.md) walkthrough that will have you debugging a Node.js web application with VS Code in minutes.
66+
* [VS Code tutorial](/docs/getstarted/getting-started.md) - A quick hands-on tour of the key features of VS Code.
67+
* [Tips and Tricks](/docs/getstarted/tips-and-tricks.md) - A collection of productivity tips for working with VS Code.
68+
* [AI-assisted coding](/docs/copilot/overview.md) - Learn about using GitHub Copilot in VS Code to help you write code faster.
6869

6970
## Common questions
7071

@@ -84,15 +85,15 @@ VS Code doesn't include a traditional **File** > **New Project** dialog or pre-i
8485

8586
On Linux and Windows, choose **Help** > **About**. On macOS, use **Code** > **About Visual Studio Code**.
8687

87-
### Why is VS Code saying my installation is Unsupported?
88+
### Why is VS Code saying my installation is unsupported?
8889

8990
VS Code has detected that some installation files have been modified, perhaps by an extension. Reinstalling VS Code will replace the affected files. See our [FAQ topic](/docs/supporting/faq.md#installation-appears-to-be-corrupt-unsupported) for more details.
9091

9192
### How can I do a 'clean' uninstall of VS Code?
9293

93-
If you want to remove all user data after [uninstalling](/docs/setup/uninstall.md) VS Code, you can delete the user data folders `Code` and `.vscode`. This will return you to the state before you installed VS Code. This can also be used to reset all settings if you don't want to uninstall VS Code.
94+
If you want to remove all user data after [uninstalling](/docs/setup/uninstall.md) VS Code, you can delete the user data folders `Code` and `.vscode`. This returns you to the state before you installed VS Code. This can also be used to reset all settings if you don't want to uninstall VS Code.
9495

95-
The folder locations will vary depending on your platform:
96+
The folder locations vary depending on your platform:
9697

9798
* **Windows** - Delete `%APPDATA%\Code` and `%USERPROFILE%\.vscode`.
9899
* **macOS** - Delete `$HOME/Library/Application Support/Code` and `~/.vscode`.

0 commit comments

Comments
 (0)