Skip to content

docs: add descriptive alt text to all images for accessibility#303

Closed
travisbreaks wants to merge 1 commit intoOpenSource-Communities:mainfrom
travisbreaks:docs/add-alt-text-accessibility
Closed

docs: add descriptive alt text to all images for accessibility#303
travisbreaks wants to merge 1 commit intoOpenSource-Communities:mainfrom
travisbreaks:docs/add-alt-text-accessibility

Conversation

@travisbreaks
Copy link
Copy Markdown

Summary

  • Replaces generic or non-descriptive alt text across all 30 images and GIFs in the docs/ directory with meaningful, descriptive alternatives
  • Alt text now conveys the content and purpose of each visual element (screenshots, GIFs, diagrams) following accessibility best practices
  • Covers all files in both docs/intro-to-oss/ and docs/becoming-a-maintainer/ sections

Changes Made

Files updated (8 total):

  • docs/becoming-a-maintainer/your-team.md - 5 images
  • docs/becoming-a-maintainer/maintainer-powerups.md - 2 images
  • docs/becoming-a-maintainer/how-to-setup-your-project.md - 3 images
  • docs/becoming-a-maintainer/metrics-and-analytics.md - 6 images
  • docs/becoming-a-maintainer/getting-practical.md - 3 images
  • docs/becoming-a-maintainer/issues-and-pull-requests.md - 1 image
  • docs/intro-to-oss/how-to-contribute-to-open-source.md - 9 images
  • docs/intro-to-oss/tools-to-be-successful.md - 1 image

Alt Text Guidelines Applied

  • Screenshots describe what is shown in the interface, not just "screenshot"
  • GIFs describe the action/workflow being demonstrated, prefixed with "Animated walkthrough of..."
  • Alt text is concise but descriptive enough for screen reader users to understand the content
  • No images were left with empty or generic alt text

Closes #266

Co-authored-by: Egger egger@horny-toad.com

Replace generic or non-descriptive alt text across all documentation
images and GIFs with meaningful descriptions that convey the content
and purpose of each visual element. This improves accessibility for
users relying on screen readers.

Closes OpenSource-Communities#266

Co-authored-by: Egger <egger@horny-toad.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented Mar 6, 2026

Deploy Preview for learn-open-source ready!

Name Link
🔨 Latest commit 08ad31b
🔍 Latest deploy log https://app.netlify.com/projects/learn-open-source/deploys/69aa41e085124d0008f32e92
😎 Deploy Preview https://deploy-preview-303--learn-open-source.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Congratulations on submitting your first Pull Request! 🎉

We appreciate your contribution. Feel free to join the conversation in our
Community and say hello!

@BekahHW BekahHW closed this Mar 6, 2026
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.

Add missing alt text for accessibility compliance

2 participants