Skip to content

Conversation

@coseeian
Copy link
Collaborator

@coseeian coseeian commented Dec 27, 2025

Summary

Adds accessibility tags (accTitle and accDescr) to the mermaid class diagram in the WebGL architecture documentation.

Motivation

In response to discussion in #168 (comment): Mermaid.js supports embedding accessibility metadata directly into generated SVG diagrams. This improves the experience for users with screen readers and other assistive technologies by providing a concise title and detailed description of the diagram's structure.

References

Testing

  • Verified the mermaid diagram renders correctly for sighted users (no visual changes).
  • Confirmed title and desc tags are present in the generated SVG.
Screenshot 2025-12-27 at 14 18 42
  • Tested with screen reader (macOS VoiceOver) to ensure title and description are announced properly.

@coseeian coseeian added the Accessibility: Best Practice No obvious current impact, but which may lead to problems in the future label Dec 27, 2025
@davepagurek
Copy link
Collaborator

Thanks @coseeian! The contributor docs don't actually originate from this repo, they start from the p5.js repo here https://github.com/processing/p5.js/tree/main/contributor_docs so that both website visitors and contributors originating from GitHub find them. Could I get you to make these changes there? Then, the next time we run npm run build:contributor-docs it will pull those changes in.

@coseeian
Copy link
Collaborator Author

coseeian commented Jan 1, 2026

@davepagurek Got it, thanks! Closing this PR now. I’ve moved the changes over to p5.js: processing/p5.js#8373.

@coseeian coseeian closed this Jan 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Accessibility: Best Practice No obvious current impact, but which may lead to problems in the future

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants