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

Add a VSCode walkthrough #17

Open
will-v-pi opened this issue May 20, 2024 · 3 comments
Open

Add a VSCode walkthrough #17

will-v-pi opened this issue May 20, 2024 · 3 comments
Labels
enhancement New feature or request
Milestone

Comments

@will-v-pi
Copy link
Collaborator

Add a walkthrough for users, to show the functionality of the extension (https://code.visualstudio.com/api/references/contribution-points#contributes.walkthroughs). This should include:

  • Description of the extension and it's purpose
  • Install instructions if on macOS (xcode-select --install)
  • Which button to click for a new project/example
  • The need to install the recommended extensions for debugging
  • What settings are useful to change (eg features, correct debugger)
  • How to connect the debugger (documentation links, or just diagrams)
  • Which buttons to click for build & debug
@will-v-pi will-v-pi added the enhancement New feature or request label May 20, 2024
@will-v-pi will-v-pi added this to the Release 1.0.0 milestone May 20, 2024
@kaycebasques
Copy link

Seems like you can close this now that the extension is covered in the main flow of getting started with pico?

@neonmik
Copy link

neonmik commented Sep 15, 2024

There's still definitely more to be done here. Why is it downing python when I already have an up to date version? I know I need to specify the path, but that's not clear to a beginner.

@paulober
Copy link
Collaborator

paulober commented Sep 16, 2024

Thanks for your feedback.

Why is it downloading python when I already have an up to date version?

Because custom Python installations from users have caused too many issues in the past, so they can't be trusted anymore by default.
If you want to use your system python, you can select "Use system version" under Python in the project generator after toggling "Advanced options" at the bottom.

There's still definitely more to be done here.

Could you please elaborate a bit more on what specifically need further work?

I know I need to specify the path, but that's not clear to a beginner.

It is explained in the README and a beginner would probably prefer having the extension taking care of the Python installation which requires no extra configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

4 participants