diff --git a/.jules/palette.md b/.jules/palette.md index a9a9d8d5..4847d8f6 100644 --- a/.jules/palette.md +++ b/.jules/palette.md @@ -1,6 +1,10 @@ ## 2024-05-15 - Enhancing Generated File Tree HTML **Learning:** Raw directory listings generated into HTML often lack critical accessibility meta tags (like `lang="en"`, `viewport` for responsive scaling) and aria-labels for directory/file links (which are otherwise non-descriptive for screen readers like just `📁 folderName`). -**Action:** Always include base semantic structures (`
`, ``, responsive meta tags) and `aria-label`s specifying the entity type (e.g., `folderName directory`) when generating raw navigation trees to ensure keyboard and screen-reader usability. Add `:focus` styles mimicking `:hover` for keyboard users. +**Action:** Always include base semantic structures (`
`, ``, responsive meta tags) and aria-labels specifying the entity type (e.g., `folderName directory`) when generating raw navigation trees to ensure keyboard and screen-reader usability. Add `:focus` styles mimicking `:hover` for keyboard users. + +## 2024-05-18 - Improve Screen Reader Experience for Directory Trees +**Learning:** Decorative unicode icons (like 📁 for folders or ↰ for back arrows) in generated HTML directory listings are read aloud by screen readers as confusing literals, degrading the user experience. +**Action:** Wrap decorative emoji and unicode symbols in `