This document lists all current challenges. Challenges are unlocked based on your skill level (determined by merged PRs).
Your Status: Check bot comments on your PRs for current level and available challenges.
- Find an available issue labeled with
challengeand your skill level - Comment "I'd like to try this!" to claim the issue
- Create a branch for your work
- Make your changes following the challenge description
- Open a pull request that references the issue (
Closes #XX) - Get peer review and incorporate feedback
- Merge when approved!
- Issue Label:
challenge: beginner,skill: markdown - Estimated Time: 10-15 minutes
- Skills: Markdown links, file paths
- Files:
docs/welcome.md
Description: Find and fix the broken internal link in the welcome guide.
What You'll Learn:
- Relative file paths in Markdown
- Testing links in preview
- Creating descriptive commits
Success Criteria:
- Link points to correct file
- Link text is descriptive
- No other broken links introduced
- Issue Label:
challenge: beginner,skill: markdown - Estimated Time: 15-20 minutes
- Skills: Markdown tables, documentation
- Files:
docs/keyboard-shortcuts.md
Description: Add a new keyboard shortcut to the reference guide.
What You'll Learn:
- Markdown table syntax
- Finding official documentation
- Clear technical writing
Success Criteria:
- Shortcut added to correct section
- Table formatting preserved
- Description is clear and accurate
- Issue Label:
challenge: beginner,skill: markdown - Estimated Time: 20-30 minutes
- Skills: Document structure, writing
- Files:
docs/welcome.md
Description: Fill in the [TODO] sections in the welcome guide.
What You'll Learn:
- Consistent documentation style
- Heading hierarchy basics
- Writing for diverse audiences
Success Criteria:
- All [TODO] markers removed
- Content is helpful and clear
- Heading hierarchy is correct
- Style matches existing content
- Issue Label:
challenge: intermediate,skill: accessibility - Estimated Time: 15-20 minutes
- Skills: Semantic HTML, screen reader navigation
- Files: Multiple docs
Description: Find and fix heading hierarchy violations throughout the docs.
What You'll Learn:
- Why heading order matters
- How screen readers use headings
- Document accessibility auditing
Success Criteria:
- No heading level skips (H1→H2→H3)
- Each document has exactly one H1
- Document outline is logical
- Bot validation passes
- Issue Label:
challenge: intermediate,skill: accessibility - Estimated Time: 20-30 minutes
- Skills: Descriptive text, context awareness
- Files: Multiple docs
Description: Replace generic link text ("click here", "read more") with descriptive alternatives.
What You'll Learn:
- Link text best practices
- Context-independent descriptions
- Screen reader user experience
Success Criteria:
- No generic link text patterns
- Links make sense out of context
- Surrounding text reads naturally
- Bot validation passes
- Issue Label:
challenge: intermediate,skill: accessibility - Estimated Time: 20-30 minutes
- Skills: Descriptive writing, image context
- Files: Multiple docs with images
Description: Add descriptive alt text to images missing it.
What You'll Learn:
- Writing effective alt text
- Informative vs. decorative images
- What screen reader users need
Success Criteria:
- All images have alt text
- Alt text is descriptive and complete
- Includes relevant text from images
- Appropriate for context
- Issue Label:
challenge: advanced,skill: review - Estimated Time: 30-45 minutes
- Skills: Code review, constructive feedback
- Context: Assigned as reviewer on peer PR
Description: Conduct comprehensive accessibility review of a peer's PR.
What You'll Learn:
- Systematic review process
- Writing helpful feedback
- Balancing thoroughness and kindness
- Identifying subtle issues
Success Criteria:
- All accessibility aspects checked
- Constructive comments provided
- Clear explanation of issues
- Suggestions for improvement
- Final approve/request changes decision
- Issue Label:
challenge: advanced,skill: documentation - Estimated Time: 2-3 hours
- Skills: Technical writing, research
- Files: New file creation
Description: Create comprehensive documentation for an accessibility topic.
What You'll Learn:
- Technical writing process
- Researching documentation
- Creating learning materials
- Practicing what you teach
Success Criteria:
- Topic thoroughly covered
- Includes practical examples
- Links to quality resources
- Document itself is accessible
- Clear and actionable guidance
- Issue Label:
challenge: advanced,skill: collaboration - Estimated Time: 1-2 hours (async)
- Skills: Teaching, empathy, patience
- Context: Assigned as reviewer for beginner
Description: Guide a beginner through completing their first challenge.
What You'll Learn:
- Teaching complex concepts simply
- Patient, encouraging feedback
- Breaking down problems
- Building confidence in others
Success Criteria:
- Timely, thoughtful review
- Questions that prompt discovery
- Explanations of WHY, not just WHAT
- Encouragement and celebration
- Beginner successfully completes challenge
- Issue Label:
challenge: expert,skill: creation - Estimated Time: 3-5 hours
- Skills: Instructional design, scoping
- Files: Challenge documentation
Description: Identify a learning gap and create a new challenge.
What You'll Learn:
- Instructional design principles
- Defining learning objectives
- Appropriate scoping
- Creating evaluation criteria
Success Criteria:
- Clear learning objective
- Appropriate difficulty
- Estimated time provided
- Resources included
- Success criteria defined
- Example solution created
- Issue Label:
challenge: expert,skill: accessibility - Estimated Time: 4-6 hours
- Skills: Systematic testing, prioritization
- Files: Audit report + issues
Description: Conduct comprehensive accessibility audit of entire repository.
What You'll Learn:
- Systematic testing methodology
- Real-world evaluation process
- Issue triage and prioritization
- Writing actionable bug reports
Success Criteria:
- All docs reviewed
- Screen reader testing completed
- Issues filed for each problem
- Problems prioritized by severity
- Comprehensive audit report written
- Suggested fixes included
- Issue Label:
challenge: expert,skill: creation - Estimated Time: 2-3 hours
- Skills: Template design, workflow optimization
- Files:
.github/ISSUE_TEMPLATE/
Description: Design an issue template for a specific challenge type.
What You'll Learn:
- Template design patterns
- Guiding user input effectively
- Workflow optimization
- GitHub community tools
Success Criteria:
- Template structure is clear
- Includes helpful guidance
- Appropriate labels/metadata
- Tested with sample issue
- Documentation updated
These challenges require collaboration with your study group:
- Group Documentation Sprint: Collaboratively improve docs
- Peer Review Circle: Everyone reviews everyone
- Accessibility Workshop: Teach each other a11y topics
- Challenge Creation: Design new challenges together
Open an issue with:
- Descriptive title
- What you want to learn
- What you plan to change/create
- Estimated difficulty level
- Label:
challenge: custom
Facilitators will review and may approve custom challenges!
Check open issues with label challenge to see what's available right now.
Issues assigned to someone are currently claimed. You can watch them to see solutions!
Closed issues with merged PRs represent completed challenges. Great for inspiration!
- Learning Paths Guide - Detailed challenge instructions
- Automation Guide - Understanding bot feedback
- PR Workflow - Step-by-step PR process
- Accessibility Guide - A11y principles
- Read bot feedback - It includes specific fixes
- Check documentation - Bot links to relevant resources
- Ask your peer reviewer - Comment on your PR
- Ask study group - Use your group issue thread
- Ask facilitators - Tag them in your PR
Before Starting:
- Read the full challenge description
- Check the learning objectives
- Review linked resources
- Make sure you have time to complete it
While Working:
- Commit early and often
- Use descriptive commit messages
- Reference the issue number
- Test your changes
During Review:
- Respond to feedback promptly
- Ask questions if unclear
- Make requested changes
- Thank your reviewers
After Merging:
- Celebrate your achievement!
- Reflect on what you learned
- Review the resources again
- Help others with similar challenges
Challenges designed for progressive skill building and real-world applicability. Every challenge completed makes you a better contributor!