layer5io / layer5io/layer5

Enhance Accessibility (a11y) and SEO via alt Attributes

Open
#7,614 3 comments 0 reactions 1 assignee View on GitHub

@Manishnemade12 is already working on this.

Since Apr 11, 2026.

framework/gatsby help wanted kind/bug
Dominant language
JavaScript
Stars
1.1k
Forks
1.6k
Avg merge
2d 10h
Merged PRs (30d)
18

Description

Description

According to AGENTS.md, all components must meet WCAG 2.1 accessibility standards. However, an audit of the src/sections and src/components directories shows rampant use of alt="" or completely missing alt attributes on critical <img> tags. Noteably, these aren't just decorative images; many are instructional (Kanvas-collaborate-banner.js, Features/index.js, AcademyFeaturesMobileSwiper.js) conveying important architectural context. Absence of descriptive alternative text negatively impacts screen-reader users, violating core CNCF accessibility principles.

Expected Behavior

A codebase sweep should be performed to systematically categorize images. Purely decorative images should retain alt="" with a supplemental aria-hidden="true", while meaningful images must be updated with descriptive strings (e.g., alt="Meshery collaboration architecture diagram"). This will fulfill the strict WCAG 2.1 compliance mandate in Layer5 guidelines, boost overall SEO indexing for cloud-native keyword ranking on major search engines, and significantly improve UX for visually impaired developers navigating community material.

Screenshots
Environment:
  • Host OS:
  • Browser:

Contributor Resources and Handbook

The layer5.io website uses Gatsby, React, and GitHub Pages. Site content is found under the master branch.

Join the Layer5 Community by submitting your community member form.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.