microsoft / microsoft/pxt-microbit
Create Tutorial user flow
Open
@jwunderl is already working on this.
Since May 15, 2026.
tutorialtool
vscode
- Dominant language
- TypeScript
- Stars
- 804
- Forks
- 721
- Avg merge
- 2d 9h
- Merged PRs (30d)
- 2
Description
Right now it's not clear what the correct flow for creating a new tutorial should be.
I see 2 main entry points:
- User wants to create a tutorial from scratch - maybe focusing on a specific concept (loops), or a specific micro:bit component (radio)
- User already has an existing micro:bit program and they want to create tutorial instructions for how to build
We should think through user flows for each of these scenarios. Right now it's confusing for both - when I click Create Tutorial, it tells me I need to open a MakeCode project first. I don't know what that means...
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.