microsoft / vscode-docs

Public documentation for Visual Studio Code
http://code.visualstudio.com/docs
Other
5.57k stars 4.52k forks source link

Update overall getting started experience #7359

Open ntrogh opened 1 month ago

ntrogh commented 1 month ago

Improve the overall getting started docs experience for new users.

ntrogh commented 1 month ago

Outline for Getting Started tutorial. The objective is to take a user through a guided tour of the key features of VS Code.

@bhavyaus here's a first draft of the outline for the VS Code getting started tutorial. Do you see any key topics that are missing for someone's first experience with VS Code?

ntrogh commented 1 month ago

@bamurtaugh sharing the draft outline for a VS Code Getting Started tutorial. Any feedback is welcome!

bhavyaus commented 1 month ago
  1. Should Customize VS Code section appear right after the Learn about the user interface section? Past user studies suggest that offering some level of customization at the start of user interactions tends to result in sustained engagement -> the first step in the getting started walkthrough is "Choose your theme". @daviddossett might have more info here.

  2. Install a language extension should be before Edit a code file so that users can edit and run the code in the language of their choice.

ntrogh commented 1 month ago

@bhavyaus thanks for the feedback. I'll incorporate it.

bamurtaugh commented 1 month ago

Thanks for putting this together, looks great!

I think it could be interesting incorporate Remote Development and GitHub Copilot, maybe as Next Steps? They could become fundamental to how users develop with VS Code everyday, so I think they could make sense to highlight somewhere in a getting started.