Skip to content

Commit 96cd1b1

Browse files
authored
Add UI navigation plain language rule to markdown accessibility instructions (#1184)
1 parent afba5b8 commit 96cd1b1

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

instructions/markdown-accessibility.instructions.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,8 @@ Good: `Read my blog post "[Crafting an accessible resume](https://example.com)"`
3838
- Flag unnecessarily complex or jargon-heavy language that could be simplified.
3939
- Favor short sentences, common words, and active voice.
4040
- Flag long, dense paragraphs that could be broken into smaller sections or lists.
41+
- When describing UI navigation, write actions as sequential steps in plain language first (e.g., "open Settings, then select Preferences"). Use generic, stable labels rather than icon names or visual descriptions.
42+
- A parenthetical visual reference may follow as supplemental context (e.g., "(gear icon > Preferences)"), but never use visual breadcrumb notation or icon names as the sole way to describe a navigation path.
4143
- When suggesting plain language improvements, present them as recommendations for the author to review. Language decisions require understanding of audience, context, and tone.
4244

4345
## 5. Lists and Emoji Usage

0 commit comments

Comments
 (0)