-
Notifications
You must be signed in to change notification settings - Fork 47
Description
Feature Description
Introduce a Personalized Learning Path (Roadmap Generator) that organizes recommended open source issues into a progressive, structured roadmap for each user. Instead of showing isolated issue recommendations, the platform should guide contributors through a step-by-step learning and contribution journey, from beginner-friendly tasks to advanced, high-impact issues.
This roadmap should adapt dynamically based on the user’s skills, completed contributions, and learning goals.
Problem Statement
While IssueMatch effectively recommends relevant issues, contributors—especially beginners—often struggle with:
-
Knowing what to work on next
-
Understanding how individual issues fit into a long-term learning journey
-
Identifying skill gaps blocking progress
-
Avoiding sudden jumps in issue difficulty
This lack of structured progression can lead to confusion, low confidence, and contributor drop-off.
Proposed Solution
Implement a Roadmap Generation Engine that creates a personalised, evolving issue roadmap for each user.
Core Components
- Difficulty Progression Logic
-
Classify issues into levels (Beginner → Intermediate → Advanced)
-
Start slightly below or at the user’s current skill level
-
Gradually increase complexity while avoiding sharp difficulty jumps
- Skill Gap Detection
-
Extract required skills from issue descriptions and labels
-
Compare against the user’s skill profile
-
Prioritise issues with manageable skill gaps that promote learning
- Dependency-Aware Issue Ordering
-
Detect implicit dependencies between issues (setup tasks, refactors, prerequisite bugs)
-
Ensure prerequisite issues appear earlier in the roadmap
-
Avoid recommending blocked or dependent tasks prematurely
- Roadmap Generation
-
Group issues into progressive phases or milestones
-
Balance learning value, contribution impact, and feasibility
-
Regenerate dynamically as the user:
-
Completes issues
-
Improves skill level
-
Changes interests or domains
-
- Frontend Timeline Visualisation
-
Display the roadmap as a visual timeline or step-based flow
-
Each item includes:
- Issue title - Difficulty level - Skills gained - Estimated effort
Status tracking: Not Started / In Progress / Completed
Component
AI/ML
Alternative Solutions
-
Static learning tracks (not personalised, limited adaptability)
-
Simple difficulty-based sorting (ignores skill gaps and dependencies)
-
Manual mentor-curated paths (not scalable)
The proposed AI-assisted roadmap system provides scalability, personalisation, and adaptability.
Additional Context
-
Strongly complements issue recommendation and mentorship features
-
Aligns with SWoC’s learning-first and mentorship-driven goals
-
Lays groundwork for future features like:
-
Career-based learning tracks
-
Contributor growth analytics
-
Goal-oriented roadmaps (e.g., backend, ML, frontend)
-