Skip to content

Fix/beckyk102125 challenge 2#2313

Open
BeckyK102125 wants to merge 4 commits intomainfrom
fix/beckyk102125-challenge-2
Open

Fix/beckyk102125 challenge 2#2313
BeckyK102125 wants to merge 4 commits intomainfrom
fix/beckyk102125-challenge-2

Conversation

@BeckyK102125
Copy link
Collaborator

@BeckyK102125 BeckyK102125 commented Mar 8, 2026

What does this PR do?

It fixes the heading levels so they are in the correct hierarchy for screen reader users.

Which issue does this close?

Closes #1847

What type of change is this?

  • Fix a bug or error in an existing file
  • Add new content or a missing section
  • Improve accessibility (headings, links, alt text)
  • Improve clarity or rewrite confusing content
  • Other (describe below)

Checklist

  • I tested my changes with a screen reader or checked heading structure
  • All links point to real files that exist in this repo
  • All images have descriptive alt text
  • No [TODO] markers remain in my changes
  • My commit message describes what changed and why

How to review this PR

  1. Read the changed file(s) in the Files Changed tab
  2. Check that headings follow proper hierarchy (H1, H2, H3 - no skips)
  3. Verify links work by clicking them
  4. Read link text out of context - does it still make sense?

Anything else?

Create docs/welcome.md — a beginner-friendly guide that explains what open source is, who can contribute, what makes a good first contribution, how to find issues, how to get help, and what happens after a PR is merged. The file includes TODOs for expanding accessibility guidance and tips on reading issues, and contains a few typos that should be proofread. Last reviewed date is included at the end of the document.
Add a new docs/keyboard-shortcuts.md file providing a comprehensive reference of keyboard shortcuts for navigating GitHub with NVDA, JAWS, and VoiceOver. Includes single-key navigation, mode-switching, reading commands, screen-reader-neutral page shortcuts, common form/input keys, and troubleshooting/workarounds to improve accessibility guidance for assistive-technology users.
Update markdown heading hierarchy in docs/keyboard-shortcuts.md: demote JAWS subsections from H3 to H4 and promote "Screen-Reader-Neutral Shortcuts" from H2 to H3 for improved structure and consistency.
@github-actions
Copy link

github-actions bot commented Mar 8, 2026

PR Validation Report

Validation Passed

✓ Required Checks

Issue Reference

PR Description

📚 Learning Resources

Based on your changes, these guides might help:


Automated validation by Learning Room Bot. Last updated: 2026-03-08T21:42:36.522Z
Questions? Check the guides or mention @Facilitator in a comment.

@github-actions
Copy link

github-actions bot commented Mar 8, 2026

📋 Content Validation Report

♿ Accessibility

  • Table Description (docs/CHALLENGES.md Line 86)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 87)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 88)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 89)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 90)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 91)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 92)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 93)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 94)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 95)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 113)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 114)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 115)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 116)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 117)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 118)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 119)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 120)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 121)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 122)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 123)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 124)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 125)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 126)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 127)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 128)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 129)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 313)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 314)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 315)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 316)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/CHALLENGES.md Line 317)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 17)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 18)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 19)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 20)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 21)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 22)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 23)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 24)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 25)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 26)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 27)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 28)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 32)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 33)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 34)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 35)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 39)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 40)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 41)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 42)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 43)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 53)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 54)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 55)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 56)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 57)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 58)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 59)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 60)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 61)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 62)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 63)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 67)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 68)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 69)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 70)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 71)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 75)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 76)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 77)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 78)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 79)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 97)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 98)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 99)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 100)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 101)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 102)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 103)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 104)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 105)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 106)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 116)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 117)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 118)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 119)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 120)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 121)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 125)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 126)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 127)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 128)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 129)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 130)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 131)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

  • Table Description (docs/keyboard-shortcuts.md Line 132)
    Consider adding a brief description before tables explaining their content.
    Fix: Add one sentence before the table explaining what data it contains.

📚 Learning Resources


Automated validation by Learning Room. Questions? Check the guides or mention @Facilitator.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Challenge 4.1

1 participant