Accessibility
We aim to make chayangujral.com usable by everyone, including readers who use assistive technology.
Target: WCAG 2.1 Level AA
Our commitment
The site is built to follow the Web Content Accessibility Guidelines (WCAG) 2.1 at Level AA. That means perceivable text, operable controls, understandable structure, and robust markup that works with assistive technology — screen readers, keyboard navigation, magnification, and voice control.
What's built in
Reading toolbar on every article
Adjustable font size (A− / A+), wide line spacing, three font faces (serif, sans-serif, dyslexia-friendly Atkinson Hyperlegible), four themes (auto, light, dark, high contrast). Settings persist via localStorage.
Listen to articles
Each article ships with pre-generated neural text-to-speech audio in MP3 format. Play / pause / stop controls and a 0.75×–2× playback speed selector. Playback position is remembered between visits.
Reduced motion
The site respects the operating system's reduced-motion preference. A "Motion: Off" button in the toolbar provides a per-visit override that pauses animated diagrams even if the OS hasn't requested it.
Keyboard navigation
Every interactive control is keyboard reachable with a visible focus ring. The first focusable element on each article is a "Skip to content" link that bypasses the toolbar. No keyboard traps.
Screen-reader markup
Semantic HTML (heading hierarchy, landmark regions, lists, tables). Architecture
diagrams are inline SVG with descriptive <title> and
<desc> elements. Toolbar buttons announce label and pressed state
via aria-pressed and aria-label.
Contrast
Body text in light and dark modes meets WCAG AA contrast ratios (≥ 4.5:1). The dedicated High Contrast theme targets AAA-level ratios (≥ 7:1) using pure black on pure white with bold weights.
Known limitations
- JavaScript required for the toolbar. Articles read fine without JS (default font, spacing, theme based on system); only the in-page controls require JavaScript.
- Audio coverage. A brand-new article may go live before its audio file is generated; the "Listen" button hides cleanly in that case.
- Voice variety. One canonical neural voice per article keeps the experience consistent; no voice picker.
- Browser support. Targets the latest two versions of Chrome, Edge, Firefox, and Safari. Older browsers will still render the content but may miss the toolbar polish.
Send feedback
Spotted an accessibility issue or want a feature added? Email chayan.gujral@ibm.com with the page URL and a short description. I read every message and reply within a week.