introduction-to-github icon indicating copy to clipboard operation
introduction-to-github copied to clipboard

[Feature] Add “Next Challenge” Section with Visual Guidance (GIF) for Advanced Learners

Open RAJVEER42 opened this issue 5 months ago • 1 comments

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 Actions Workflow

GitHub Issue to PR Workflow

  1. Create an Issue

    • Navigate to Issues tab → New Issue
    • Add title, description, and labels
  2. Create a Branch

    • git checkout -b feature/issue-123
  3. Link to Pull Request

    • In PR description, add: Closes #123
    • Or use the sidebar "Development" section
  4. 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!

RAJVEER42 avatar Jul 24 '25 17:07 RAJVEER42

@RAJVEER42, Thank you for the thought-out feedback for adding additional content to the exercise. We are in the middle of big shift at the moment, but I have made a note to come back and take a look at this. Thanks! 🧑‍🚀

chriswblake avatar Jul 25 '25 13:07 chriswblake