lingo.dev icon indicating copy to clipboard operation
lingo.dev copied to clipboard

Add Descriptive `alt` Attributes to Decorative Images for Better Accessibility & SEO

Open Neetesh26 opened this issue 1 month ago โ€ข 6 comments

๐Ÿ“„ Description

Some images on the Lingo.dev website appear to be missing descriptive alt attributes or use generic ones such as "image" or "screenshot".

Adding meaningful alt text improves:

  • ๐Ÿฆป Accessibility for screen readers (users with visual impairments)
  • ๐Ÿš€ SEO ranking and better crawlability
  • ๐Ÿ’Ž Code quality following WCAG best practices

๐Ÿ” Affected Sections

  • ๐Ÿ  Homepage hero image
  • ๐Ÿ–ผ๏ธ Product demo / feature illustrations
  • โš™๏ธ Integrations section icons
  • ๐Ÿ”— Footer or partner logos (if any)

๐Ÿ’ก Suggested Solution

Perform an accessibility audit across all <img> elements and update their alt attributes appropriately.

โœ… Example Fix

<!-- Before -->
<img src="/assets/hero.png" alt="image" />

<!-- After -->
<img src="/assets/hero.png" alt="Screenshot of Lingo.dev localization dashboard showing AI translation tools" />

๐Ÿงฉ Decorative Images

If any image is purely decorative (e.g., abstract background shapes), use:

<img src="/assets/bg-decor.svg" alt="" role="presentation" />

๐Ÿง  Why This Adds Value

Improving image accessibility:

  • ๐ŸŒ Makes the website inclusive for all users
  • ๐Ÿ“ˆ Strengthens SEO & content indexing
  • ๐Ÿ’ก Demonstrates Lingo.devโ€™s commitment to high-quality, accessible web design โ€” which aligns with its localization mission

๐Ÿ™‹โ€โ™‚๏ธ Assignee

@NeeteshPrajapati

Neetesh26 avatar Oct 30 '25 13:10 Neetesh26

Hi! @Neetesh26 Iโ€™d like to take up this issue and work on fixing it. Could you please assign it to me?

deveshshukla avatar Oct 30 '25 13:10 deveshshukla

Iโ€™ll get those alt attributes in place for SEO goodness and tidy up the decorative images with role="presentation" for smooth crawling. Letโ€™s make this site shine @Neetesh26

satyam-skr avatar Oct 30 '25 13:10 satyam-skr

Hey @Neetesh26 , hope you're doing great! Iโ€™d love to contribute to this project, and I thought starting with some basics would be a good way to begin. Could you please assign it to me?

gagan052 avatar Oct 30 '25 14:10 gagan052

Hi @Neetesh26 , Iโ€™ve added the alt Attributes to Decorative Images for Better Accessibility & SEO for the Lingo.Dev (issue #1410). Could you please review and approve the workflows? Thanks! ๐Ÿ˜Š

gagan052 avatar Oct 30 '25 14:10 gagan052

@gagan052 Please maintain a proper channel without assigning issues youโ€™ve worked on yourself. If everyone does the same thing, then whatโ€™s the point of getting approval? Donโ€™t cross the line everywhere.

deveshshukla avatar Oct 31 '25 05:10 deveshshukla

Hey @Neetesh26 do you have some images you can link that should be improved?

Since our website isn't open source as of now, I can't directly assign it to you but you WILL get credits for this if we make improvements to our website based on your findings/suggestions.

As for submitting unwarranted PRs and working on an issue without being assigned one @gagan052 @deveshshukla @satyam-skr please note that this is the convention we follow and be respectful of this please:

Image

Submitting a PR without getting the issue assigned just wastes everyone's time and so please refrain from doing so.

If you want to contribute, please find an issue that hasn't been claimed by anyone and drop a comment there asking to be assinged.

If you can't find such an open issue, please try using the product in different environments to see if you can find any bug/features that you want to work on, create an issue and get assigned.

We have a ton of scope for potential contribution and so don't limit yourself to an issue that has already been claimed. Go through our guides, see if there's any framework that you can write a guide about.

Everything counts!

Happy contributing!

sumitsaurabh927 avatar Oct 31 '25 18:10 sumitsaurabh927

Thanks for reporting! This will be handled by the Lingo.dev core team in our separate website repo. We'll close this once it's resolved there.

maxprilutskiy avatar Nov 10 '25 06:11 maxprilutskiy