AWS Open Source Documentation Accessibility

Before launching Write-Brained full-time, Melissa Vagi worked for four years at Amazon Web Services. During her time there, she led the creation of documentation that complied with Section 508 and WCAG standards for the Public Sector group and the OpenSearch application. Her efforts reached millions of global developers who rely on assistive technology.

Project Overview

As Senior Technical Writer for AWS OpenSearch, ensured Section 508/WCAG compliance across comprehensive documentation created from scratch for open-source software users. Maintained accessibility standards throughout the content lifecycle—from Markdown authoring in GitHub to publication—adhering to AWS and Linux Foundation guidelines for inclusive developer resources. Led accessible UI copy for the dashboard redesign, revamped the site information architecture to improve screen reader navigation, and established QA processes to ensure technical accuracy and accessibility compliance. Facilitated enterprise-wide writing workshops to elevate accessible communication practices.

Problem

OpenSearch documentation required strict accessibility compliance to serve millions of global developers, including those using assistive technology. The open source project needed scalable processes maintaining WCAG standards across continuous content updates, complex technical information, and diverse user needs. GitHub/Markdown workflow required systematic accessibility integration—proper heading hierarchy, alt text for visual elements, and semantic structure—while keeping a rapid development pace and technical accuracy.

Solutions

Accessible Content Development

  • Created comprehensive documentation with Section 508/WCAG compliance embedded from inception

  • Authored accessible UI copy for dashboard product redesign, ensuring assistive technology compatibility

  • Applied systematic heading hierarchy, alt text, and semantic HTML structure in Markdown workflow

Information Architecture & Accessibility

  • Revamped documentation site information architecture, improving screen reader navigation and SEO

  • Introduced AI-powered content analysis, identifying accessibility gaps and optimization opportunities

  • Optimized content structure supporting both visual and assistive technology users

Quality Assurance & Standards

  • Defined QA processes for accessibility testing, code example verification, and technical accuracy

  • Ensured compliance with AWS and Linux Foundation accessibility guidelines

  • Established systematic review processes, maintaining standards across distributed teams.

Team Enablement

  • Facilitated enterprise-wide writing workshops, including accessible communication best practices

  • Mentored team members on accessibility integration in technical writing

  • Created reusable guidelines for sustainable, compliant content production

Results

  • Delivered accessibility-compliant documentation from ground up, serving millions of open source developers worldwide

  • Improved documentation usability through accessible information architecture and systematic QA processes

  • Elevated organization-wide writing standards through workshops and mentorship, embedding accessibility throughout content lifecycle

  • Established scalable processes, maintaining Section 508/WCAG compliance across continuous updates and rapid development cycles.

Workshop Presentation

“Contributing OpenSearch documentation: a quick guide for developers”: View presentation on YouTube.

Previous

Jefferson County Colorado Digital Accessibility Case Study
Next

CDM Smith Editorial Program Implementation