-
Notifications
You must be signed in to change notification settings - Fork 12.9k
Description
Summary
After completing the "Introduction to GitHub" exercise, learners often seek the next step to continue growing. Currently, the tutorial ends once the pull request is merged — missing an opportunity to introduce core collaboration tools like Issues, Labels, and Linked PRs.
This feature proposes adding a “Next Challenge” section that encourages learners to:
- Create a GitHub Issue in their forked repo
- Assign themselves
- Link it to a new PR
- Explore basic project flow (similar to real-world open source)
Changes
This feature would introduce:
- A new section at the end of the tutorial titled “What’s Next?”
- A visual GIF demonstrating the creation of an Issue and linking it to a PR
- A checklist learners can follow to practice GitHub workflows:
- Create an issue
- Assign yourself
- Add a label (e.g.,
enhancement
) - Create a branch for the issue
- Open and link a pull request
- Merge PR
Risks/Considerations:
- Adding this section may slightly increase the exercise duration (~10 mins)
- Should be marked as optional to avoid overwhelming absolute beginners
Alternatives considered:
- Embedding this challenge in a separate follow-up course
- Offering it as a bonus GitHub Skills module
Additional context
Here’s a sample GIF that visually guides users on how to create and link an issue with a pull request:
GitHub Issue to PR Workflow
-
Create an Issue
- Navigate to Issues tab → New Issue
- Add title, description, and labels
-
Create a Branch
git checkout -b feature/issue-123
-
Link to Pull Request
- In PR description, add:
Closes #123
- Or use the sidebar "Development" section
- In PR description, add:
-
Merge and Auto-close
- When PR merges, issue closes automatically
This approach helps reinforce GitHub fundamentals and bridges the gap between classroom learning and open-source collaboration.
I'd be happy to submit a PR for this feature. Let me know your thoughts!