Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Consider what content to include in built-in walkthroughs #166047

Open
daviddossett opened this issue Nov 10, 2022 · 0 comments
Open

Consider what content to include in built-in walkthroughs #166047

daviddossett opened this issue Nov 10, 2022 · 0 comments
Assignees
Labels
getting-started under-discussion Issue is under discussion for relevance, priority, approach
Milestone

Comments

@daviddossett
Copy link
Contributor

Ref #165846

My hunch is that there is an opportunity to get more crisp on what we want users to know in the first seconds/minutes of using the product and reflect that in the getting started experience.

In general, it feels like the specific steps of the walkthroughs are somewhat arbitrary in their order and grouping. My sense is that users wouldn't know which section contains what content by looking at the titles alone. And sometime the titles say one thing where the content implies another. Example: "Get Started with VS Code" is framed as customization, but the steps are related to productivity-boosters like the command palette. Or basic JTBD like opening your code.

These aren't exhaustive comments, but some "first" impressions with fresh eyes:

Get Started with VS Code

Settings sync feels like a advanced feature to throw in as a second step in the very first walkthrough. And should opening your code be much higher up the list? Seems like a grab bag of activities here.

CleanShot 2022-11-10 at 12 26 04@2x

Learn the fundamentals

This also feels like a mixed framing re: features vs. outcomes. What is the goal of this section? Is it coding faster/smarter, or learning about features like the terminal or settings?

CleanShot 2022-11-10 at 12 29 40@2x

Boost your productivity

While shortcuts and side-by-side fit nicely here, using git feels like a core concept that might be better served in an earlier walkthrough.

CleanShot 2022-11-10 at 12 30 49@2x

@daviddossett daviddossett changed the title Consider which steps to include in basic built-in walkthroughs Consider what content to include in built-in walkthroughs Nov 10, 2022
@bhavyaus bhavyaus added bug Issue identified by VS Code Team member as probable bug under-discussion Issue is under discussion for relevance, priority, approach and removed bug Issue identified by VS Code Team member as probable bug labels Dec 5, 2022
@bhavyaus bhavyaus added this to the February 2023 milestone Dec 9, 2022
@daviddossett daviddossett modified the milestones: February 2023, Backlog Feb 21, 2023
@bhavyaus bhavyaus added polish Cleanup and polish issue and removed polish Cleanup and polish issue labels Jan 26, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
getting-started under-discussion Issue is under discussion for relevance, priority, approach
Projects
None yet
Development

No branches or pull requests

3 participants