Skip to content

Commit e29a2b9

Browse files
committed
Add UI navigation plain language rule to markdown accessibility instructions
1 parent 4c98da8 commit e29a2b9

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)