From f7674f57e546214208d6de48552fa38c547dae77 Mon Sep 17 00:00:00 2001 From: Roberto Perez Date: Mon, 23 Feb 2026 21:30:53 +0000 Subject: [PATCH] Address review feedback: fix alt text example and soften H1 priority wording --- instructions/markdown-accessibility.instructions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/instructions/markdown-accessibility.instructions.md b/instructions/markdown-accessibility.instructions.md index ea4d0cb2..ecf645d5 100644 --- a/instructions/markdown-accessibility.instructions.md +++ b/instructions/markdown-accessibility.instructions.md @@ -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