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

Intermediate content for Getting Started #120602

Merged
merged 6 commits into from
Apr 20, 2021
Merged

Conversation

digitarald
Copy link
Contributor

@digitarald digitarald commented Apr 6, 2021

This PR fixes #118281.

Git has 3 different tasks that trigger based on a) no folder open (clone), b) folder without git open (init repo) and c) open scm view (folder with git open).

Screen recording of the flow and in which contexts tasks appear:

intermediate.mp4

Skipped on high-contrast images for now to save bytes as we try this out in Insiders, gather feedback and tweak content.

Copy link
Contributor

@sana-ajani sana-ajani left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added a few optional wording suggestions, but looks good!

Hot take: can we add "LiveShare" as an entry in this intermediate list? I know it's not really a productivity tip, but I really think a) it's one of the more life-changing, sticky features/extensions of VS Code that users should know exists especially now in remote times and b) it could be a "first-class" extension in the editor, because its language agnostic.

I might suggest swapping it with tasks or hotkeys, because I think more people will actually be able to use it. (So not sure if it belongs in the intermediate section... or in the fundamentals perhaps?)

Title: "Collaborate and code remotely"
Description: Edit and debug your code in real-time. Invite your friends and colleagues to join your coding session.
Button: Open extension view with id:@"ms-vsliveshare.vsliveshare-pack"

{
id: 'playground',
title: localize('gettingStarted.playground.title', "Redefine your editing skills"),
description: localize('gettingStarted.playground.description', "Want to code faster and smarter? Practice powerful code editing feature without creating files or a project."),
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like framing this as practicing without creating a project, but I also think of the tips in interactive playground as life hacks. Perhaps: "Want to code faster and smarter? Practice these must-know editing hacks in the playground."

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Life hacks makes some sense, but hacks doesn't seem the right for multi-cursor. Lets try this out as less formal version during the content experiment!

title: localize('gettingStarted.playground.title', "Redefine your editing skills"),
description: localize('gettingStarted.playground.description', "Want to code faster and smarter? Practice powerful code editing feature without creating files or a project."),
button: {
title: localize('gettingStarted.playground.button', "Interactive Playground"),
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To stay consistent with button labels starting with a verb, should this be "Open Interactive Playground" or "Open Playground"?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was concerned about space, as we have a few buttons that have line-breaks. This one seems fine though.

{
id: 'scmClone',
title: localize('gettingStarted.scm.title', "Track your code with Git"),
description: localize('gettingStarted.scmSetup.description', "Set up your project to use Git and GitHub integration right inside your editor."),
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"right inside your editor" seems awkward, since they are already inside the editor. Maybe, "set up your project to use Git and GitHub with a click of a button?" to show how easy it is from VS Code?

@digitarald digitarald requested a review from gregvanl April 7, 2021 16:12
@digitarald
Copy link
Contributor Author

@sana-ajani 🤩.

can we add "LiveShare" as an entry in this intermediate list?

Yes, was on my list, aiting on #119502. Also a WSL mention for windows users.

{
id: 'shortcuts',
title: localize('gettingStarted.shortcuts.title', "Customize your shortcuts"),
description: localize('gettingStarted.shortcuts.description', "Once you discovered your favorite commands, lookup and customize their keyboard shortcuts for instant access."),
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion:
"Once you have discovered your favorite commands, create custom keyboard shortcuts for instant access."

@digitarald digitarald merged commit 008c208 into main Apr 20, 2021
@digitarald digitarald deleted the digitarald/intermediate branch April 20, 2021 16:23
@github-actions github-actions bot locked and limited conversation to collaborators Jun 4, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Getting Started] Add more content for experienced users
3 participants