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
- 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`).
- 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.
@@ -59,7 +59,7 @@ Good: `Read my blog post "[Crafting an accessible resume](https://example.com)"`
When multiple issues exist, prioritize in this order:
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
4. Emoji used as bullet points or list markers
5. Plain language improvements