Completing Path Challenges
Learning paths contain both articles and coding challenges. This guide explains the workflow for completing challenge steps within a path.
Table of contents
The Challenge Workflow
When you reach a challenge step in a learning path, you work through a five-stage process:
Start → Submit → Refactor → Review → Complete
Each stage must be completed before moving to the next.
Stage 1: Start
Begin by reviewing the challenge:
- Read the challenge brief and requirements
- Download any design files or assets
- Set up your development environment
- Build your solution
Take time to understand what's being asked before coding.
Stage 2: Submit
Once you've built your solution:
- Enter your repository URL
- Add your live site URL
- Fill out the submission details
- Click Submit
Your submission should be complete and working. Don't worry about perfection—you'll have a chance to improve it next.
Note: If you have already completed the challenge outside of the learning path, you'll see a blue box at the top of the form where you can select your solution as a submission inside the path.
Stage 3: Refactor
After submitting, you'll see your solution reports and can compare your work against the design. Use this stage to:
- Review your solution reports for issues
- Compare your implementation to the design
- Improve your code based on what you learn
- Update your solution
This is where you refine your work before moving on.
Stage 4: Review
The review stage is peer review—you review another community member's solution:
- You're shown another user's submitted solution
- Review their code and implementation
- Provide constructive feedback via a comment
- Submit your review to continue
Reviewing others' code helps you learn different approaches and reinforces best practices.
Stage 5: Complete
After completing your peer review:
- You'll see a completion celebration
- The next step in the path unlocks
- You can continue to the next article or challenge
Article Steps
Not every step is a challenge. Article steps are simpler:
- Read through the educational content
- Click Continue when finished
Articles typically cover concepts you'll apply in the next challenge, so read them carefully.
How Steps Unlock
Learning paths use sequential unlocking:
- Only the first step is available initially
- Completing a step unlocks the next one
- You cannot skip ahead
This ensures you build knowledge in the intended order.
Path Completion
To complete a learning path:
- Work through every step
- Complete all challenge stages (including peer review)
- Read all articles
Your completion is recorded on your profile, and you can revisit any step at any time.