Address review feedback: fix alt text example and soften H1 priority wording

This commit is contained in:
Roberto Perez
2026-02-23 21:30:53 +00:00
parent 732bfa7e04
commit f7674f57e5

View File

@@ -19,7 +19,7 @@ Good: `Read my blog post "[Crafting an accessible resume](https://example.com)"`
## 2. Image Alt Text ## 2. Image Alt Text
- Flag images with empty alt text (`![]()`) unless they are explicitly decorative. - Flag images with empty alt text (e.g., `![](path/to/image.png)`) unless they are explicitly decorative.
- Flag alt text that is a filename (e.g., `img_1234.jpg`) or generic placeholder (e.g., `screenshot`, `image`). - Flag alt text that is a filename (e.g., `img_1234.jpg`) or generic placeholder (e.g., `screenshot`, `image`).
- Alt text should be succinct and descriptive. Include any text visible in the image. - Alt text should be succinct and descriptive. Include any text visible in the image.
- Use "screenshot of" where relevant, but do not prefix with "image of" since screen readers announce that automatically. - Use "screenshot of" where relevant, but do not prefix with "image of" since screen readers announce that automatically.
@@ -59,7 +59,7 @@ Good: `Read my blog post "[Crafting an accessible resume](https://example.com)"`
When multiple issues exist, prioritize in this order: When multiple issues exist, prioritize in this order:
1. Missing or empty alt text on images 1. Missing or empty alt text on images
2. Skipped heading levels or missing H1 2. Skipped heading levels or heading hierarchy issues
3. Non-descriptive link text 3. Non-descriptive link text
4. Emoji used as bullet points or list markers 4. Emoji used as bullet points or list markers
5. Plain language improvements 5. Plain language improvements