[Image] Excessively long alternative text

[coseeian]

Title

[Image] Excessively long alternative text

Description

An image (<img>) element on the page with very long (over 100 characters) alternative text. Non-text content must convey the same purpose or information as presented visually. When alt text is too long, users who rely on it may miss essential context or struggle to understand the content.

Steps to Reproduce

1. go to tutorials/ and tutorials/setting-up-your-environment/
2. Locate to the following element

<img class="aspect-photo object-cover" height="293" width="440" src="/_astro/SetupA.MT9CUmVs_UdPSt.webp" loading="eager" decoding="async" alt="An interactive sketch in the p5.js Web Editor draws circles on the canvas as the mouse pointer moves." style="">

<img height="1152" width="2048" src="/_astro/p5_editor_sign_up_page.ti-nvYfB_Z17jU5E.webp" loading="lazy" infersize="true" decoding="async" aspectratio="none" alt="An arrow pointing to the highlighted User Name, Emaill, Password, and Confirm Password fields on the Sign Up page." style="">

Actual Behavior

The image’s alt attribute contains more than 100 characters of description.

Expected Behavior

Alternative text should be concise and focused, describing the essential content and function of the image in a brief phrase or sentence.

Environments

No response

Suggested Fix

1. Keep the alt text brief and focused—describe only the image’s essential purpose in a few words.
2. If readers need more context, place supplementary details next to the image or link to a separate description page.
3. Avoid hiding unique information solely in the alt text; ensure all critical content is visible elsewhere on the page.

Reference

• 1.1.1 Non-text Content
• F67: Failure of Success Criterion 1.1.1 and 1.2.1 due to providing long descriptions for non-text content that does not serve the same purpose or does not present the same information
• G73: Providing a long description in another location with a link to it that is immediately adjacent to the non-text content
• G74: Providing a long description in text near the non-text content, with a reference to the location of the long description in the short description

What is your operating system?

None

Web browser and version

No response

[sprinklehappiness]

Hey ! Can I work on this issue ?

[ksen0]

Hi @sprinklehappiness ! The string one mentioned is on this .mdx page so you're welcome to make a PR based on the main branch first with a proposed rephrase, and once that is approved and merged, make the same PR on the other branch. I'll assign this to you. Woudl you also want to check other tutorials in case any others have alt texts longer than 100 characters?

[sprinklehappiness]

@ksen0 Could you please review the changes ?

[ksen0]

Hi @sprinklehappiness , I've added some comments! Thanks for the patience. Happy to merge that PR when it's ready, and to keep this issue open for you (or anyone else) to find other too-long alt texts on other pages.