Update overall getting started experience
Improve the overall getting started docs experience for new users.
- [x] Review getting started documentation section and
- [x] Create an outline for a guided getting started experience.
- [ ] Create Getting Started tutorial
- [ ] Update docs landing page and CTAs
- [ ] Evaluate how we can align the in-product walkthroughs with the Getting Started tutorial.
Outline for Getting Started tutorial. The objective is to take a user through a guided tour of the key features of VS Code.
- Open a workspace
- Create a new folder
- Open folder in VS Code
- Explain concept of workspace
- Learn about the user interface
- Activity Bar + views
- Editor
- Panel (mention integrated terminal)
- Command Palette
- Edit a code file
- Create
app.jsfile - Intro to IntelliSense
- Enable auto save
- Create a Python file -> no IntelliSense
- Create
- Install a language extension
- Install Python extension -> IntelliSense, Debugging, Testing, ...
- Many other extensions available (themes, ...)
- Run your code
- Make sure Node is installed
- Open integrated terminal > node app.js
- Use F5 to use built-in debugging capabilities
- Customize VS Code
- Appearance -> change color theme
- Settings -> Font Size
- Much more, such as keybindings, ...
- Next steps
- Tips & tricks
- Edit basics
- Source control
- Integrated terminal
- Debugging
- Testing
@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?
@bamurtaugh sharing the draft outline for a VS Code Getting Started tutorial. Any feedback is welcome!
-
Should
Customize VS Codesection appear right after theLearn about the user interfacesection? 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. -
Install a language extensionshould be beforeEdit a code fileso that users can edit and run the code in the language of their choice.
@bhavyaus thanks for the feedback. I'll incorporate it.
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.