Clarify GitHub Skills Workflow: Fix Confusion on Branch Naming & Mismatched Workflow Steps

[Diksha-3905]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/skills/introduction-to-github

What part(s) of the article would you like to see updated?

The "Introduction to GitHub" Skills course instructions, specifically the workflow section involving branch creation, commits, and pull requests. Currently, the order of steps is unclear and often leads to "workflow mismatch" errors for beginners.

Beginners frequently get stuck with workflow mismatch errors because the documentation doesn't clearly explain the required order of operations or the correct branch naming convention.

By adding:

• A simple step-by-step diagram of the workflow
• Clear examples of branch naming
• Troubleshooting tips for workflow mismatch errors

…the documentation will become more beginner-friendly, improve the GitHub Skills learning experience, and reduce frustration for first-time users.

Additional information

This issue occurs reliably during the GitHub Skills course whenever the branch is created in a different order than expected. Many beginners report being blocked at this step.

Suggested improvements:

• Include screenshots of correct branch creation and pull request steps.
• Add a FAQ section addressing common workflow mismatch errors.

This change would positively impact thousands of new GitHub learners.

[welcome]

Thanks for opening this issue. A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

[Diksha-3905]

Hi maintainers,

I'm opening this issue because as a beginner going through the Introduction to GitHub Skills course, I repeatedly encountered the "workflow mismatch" problem. I think clarifying the steps with better documentation would help thousands of new users.

I'm happy to work on this and submit a PR if the team agrees with the proposed improvements. Could someone guide me on:

• Where exactly to make the changes in the repo?
• Any existing style guide or template for Skills course documentation updates?

Thank you for maintaining such an important repo!

[Sharra-writes]

Hi, @Diksha-3905! In general I would say that this is an issue that should be opened up in the introduction-to-github repo, but we're also sorting some things out right now, so I can't guarantee it will get picked up quickly. Still, the primary maintainer over there is very dedicated and passionate, so he might be able to make time to work on it. I'm going to let you close this out when you have an issue open over there, just because I want to be sure there's no weirdness with opening one, but if you could come back and do that when you've got it open, I would appreciate it. 💛