Global Rabbits L.L.C.
contact@[Link]
MASTERING ACCESSIBILITY REPORTING:
IDENTIFYING AND DOCUMENTING WEB
ACCESSIBILITY ISSUES
Introduction: About Accessibility reports
DISCLAIMER
This bootcamp is an internal training program provided by Global Rabbits to enhance
participants’ skills and knowledge. The content, resources, and materials are designed
for educational purposes only and may not comprehensively cover all aspects of the
subject matter.
Participation in this bootcamp does not guarantee employment, promotion, or any
specific career outcome within Global Rabbits or elsewhere. Selection for roles or
projects remains subject to Global Rabbits’s standard hiring and evaluation processes.
Global Rabbits makes no warranties, express or implied, regarding the accuracy,
applicability, or completeness of the content provided.
All materials shared during the bootcamp, including presentations, documentation, and
tools, are proprietary to Global Rabbits and may not be copied, shared, or distributed.
By participating in this bootcamp, you acknowledge and agree to these terms. If you have
any questions, contact HR.
Mastering Accessibility Reporting:
Identifying and Documenting Web
Accessibility Issues
Contents
Introduction ................................................................................................................................ 2
What You’ll Learn: .................................................................................................................. 2
Why do we create accessibility reports? ................................................................................. 3
Why learn how to realize accessibility reports?....................................................................... 4
Accessibility Testing Guide ..................................................................................................... 4
The Four key principles of accessibility testing ....................................................................... 6
Testing Tools .......................................................................................................................... 7
About Reports ........................................................................................................................ 8
GLOBAL RABBITS L.L.C. 1
Mastering Accessibility Reporting:
Identifying and Documenting Web
Accessibility Issues
Introduction
Welcome to the Accessibility Reporting and Testing Bootcamp!
In today’s digital world, creating inclusive and accessible products is not just a best practice—
it’s a necessity. This bootcamp is designed to equip you with the knowledge and skills needed
to identify accessibility issues, create effective accessibility reports, and suggest
practical solutions to make digital products usable for everyone, regardless of ability.
This program is designed for experienced testers with an interest in accessibility and basic skills
in the field, who wish to learn a standardized approach to conducting audits and creating reports
in the workplace.
Before starting the bootcamp, the ideal candidate would:
● Have solid experience in testing
● Know how to use NVDA and other tools such as CCA, axe, browser stack, accessibility
insights o wave.
● Spot errors in the code
● Show attention to detail and organization during the testing process
● Speak English (at least B1)
What You’ll Learn:
1. Understanding Accessibility: You’ll begin by learning the core principles of digital
accessibility, including the diverse needs of people with disabilities and why accessibility
matters in both ethical and legal contexts.
2. Conducting Accessibility Audits: We’ll dive into the process of conducting
accessibility audits, teaching you how to evaluate websites, mobile apps, and software
for compliance with key accessibility standards, such as WCAG (Web Content
Accessibility Guidelines) and ADA (Americans with Disabilities Act).
3. Creating Clear Accessibility Reports: You’ll learn how to write detailed, actionable
accessibility reports that clearly outline issues, their severity, and their impact on users.
We’ll also show you how to frame reports that provide concrete solutions for
remediation.
4. Suggesting Solutions: Knowing how to identify accessibility issues is only half the
battle. In this bootcamp, we’ll focus on how to suggest practical solutions that
development teams can implement to improve accessibility. This includes fixing common
problems like poor contrast, missing alt text, keyboard navigation issues, and much
more.
5. Basic Mobile and Software Accessibility Testing: You’ll gain hands-on experience
with testing for accessibility in mobile apps and software interfaces. This section will
cover best practices for evaluating apps and platforms on both iOS and Android, as well
GLOBAL RABBITS L.L.C. 2
Mastering Accessibility Reporting:
Identifying and Documenting Web
Accessibility Issues
as techniques for testing with assistive technologies like screen readers and voice
control.
By the end of this bootcamp, you’ll be able to confidently assess and report on accessibility,
identify barriers, and recommend practical solutions that make your digital products accessible
to all users. Whether you're a designer, developer, product manager, or QA tester, these skills
are vital for building inclusive, user-friendly experiences.
Let’s get started on your journey to becoming an accessibility advocate!
IMPORTANT: This bootcamp teaches how to communicate the results of your accessibility
testing in an effective and comprehensive report, but NOT Accessibility testing itself.
Why do we create accessibility reports?
The importance of realizing accessibility reports—or conducting accessibility audits and
generating reports for digital products—cannot be overstated. These reports play a crucial role
in ensuring that digital experiences are inclusive, functional, and compliant with relevant
standards. Here's why they're so important:
Inclusivity: Ensures that people with disabilities can access and use your digital products,
fostering equal access for all users.
Legal Compliance: Helps meet legal requirements (e.g., ADA, WCAG), reducing the risk of
lawsuits or fines.
Better User Experience: Accessibility improvements often lead to a better overall user
experience, benefiting everyone, not just those with disabilities.
Wider Audience Reach: By being accessible, you tap into a larger, underserved audience,
including people with disabilities and aging users.
SEO Benefits: Accessibility practices align with good SEO, improving search engine visibility
and traffic.
Risk Management: Identifies potential issues early, reducing legal and financial risks from non-
compliance or inaccessibility.
Brand Reputation: Shows commitment to inclusivity and social responsibility, building trust with
users.
Ethical Responsibility: Ensures digital products are equitable and accessible to all, aligning
with moral obligations.
Continuous Improvement: Regular reports help maintain accessibility as your digital products
evolve, ensuring long-term compliance.
GLOBAL RABBITS L.L.C. 3
Mastering Accessibility Reporting:
Identifying and Documenting Web
Accessibility Issues
Why learn how to realize accessibility reports?
Accessibility audits and issue reporting are fundamentally different from other types of reports in
the IT industry. It's essential to understand these differences and know what key aspects to
focus on when generating accessibility reports, this is essential to ensuring thorough and
effective audits..
Here’s a breakdown of how they work differently, and what should be the focus when reporting
accessibility issues:
1. WCAG Compliance: Identify non-compliance with WCAG 2.1 guidelines (e.g., color
contrast, keyboard navigation, alt text).
2. Assistive Tech Testing: Evaluate how the site works with screen readers, keyboard-
only navigation, and other assistive devices.
3. User-Centered Reporting: Focus on the user experience for people with disabilities, not
just technical issues.
4. Specific Recommendations: Provide clear, actionable steps to fix issues, linked to
relevant guidelines.
5. Legal Compliance: Ensure the product meets accessibility laws (e.g., ADA, Section
508).
6. Ethical Responsibility: Ensure equal access to all users, showing empathy for people
with disabilities.
In short, accessibility audits are unique because they focus on how accessible and usable a
product is for people with disabilities, ensuring compliance with legal standards, and improving
overall user experience. Unlike general IT reports that focus on performance or functionality,
accessibility reporting requires attention to detail, inclusivity, and an understanding of both
technical requirements and human factors.
Accessibility Testing Guide
The guide of accessibility testing provide a foundational framework to guide the process of
evaluating digital products for accessibility issues. These indications ensure that testing is
comprehensive, consistent, and focused on improving the user experience for people with
disabilities. Below are the key principles to follow when conducting accessibility testing:
1. Test Early and Often
Accessibility should be part of the process from the start. Regular testing during design,
development, and post-launch ensures issues are caught early.
2. User-Centered Approach
Focus on real users with disabilities and test how they interact with your product using assistive
technologies (e.g., screen readers, keyboard-only navigation).
GLOBAL RABBITS L.L.C. 4
Mastering Accessibility Reporting:
Identifying and Documenting Web
Accessibility Issues
3. Follow Standards and Guidelines
Adhere to recognized guidelines like WCAG and legal standards (e.g., ADA) to ensure
compliance and consistency.
4. Holistic Testing Across Devices and Contexts
Test on multiple devices (desktop, mobile) and browsers, considering different environments
(e.g., poor lighting, noisy settings).
5. Test with Assistive Technologies
Use tools like JAWS, NVDA, and VoiceOver to simulate the experience of users who rely on
assistive devices.
6. Iterative and Continuous Testing
Accessibility should be continuously tested and maintained as the product evolves. Regular
audits are necessary after each update.
7. Prioritize High-Impact Issues
Focus on critical issues (e.g., broken navigation, missing alt text) that severely impact usability
for people with disabilities.
8. Manual + Automated Testing
Combine automated tools (e.g., Axe, Lighthouse) with manual testing to catch both simple and
complex accessibility issues.
9. Involve Users with Disabilities
If possible, involve people with disabilities in testing to gather authentic feedback on the
product’s accessibility.
10. Document Issues and Provide Solutions
Clearly report issues with detailed descriptions and actionable solutions, referencing relevant
guidelines (e.g., WCAG).
11. Educate and Advocate
Advocate for accessibility as an ongoing priority and educate your team to create a culture of
inclusion.
GLOBAL RABBITS L.L.C. 5
Mastering Accessibility Reporting:
Identifying and Documenting Web
Accessibility Issues
The Four key principles of accessibility testing
1. Perceivable
● What it means: Information and user interface components must be presented in ways
that all users can perceive, regardless of their sensory abilities (e.g., vision, hearing).
● Focus: Ensure content is available to all senses through text alternatives (like alt text for
images), captions for audio, and sufficient color contrast.
2. Operable
● What it means: The user interface and navigation must be operable by all users,
including those with limited motor abilities or who rely on assistive technologies.
● Focus: Ensure users can interact with content using keyboard navigation, mouse, or
voice commands. All interactive elements (buttons, links, forms) must be fully
accessible.
3. Understandable
● What it means: Information and operation of the user interface must be understandable
to all users, including those with cognitive or learning disabilities.
● Focus: Make content clear and predictable. Use simple language, consistent navigation,
and logical layout to help users easily understand and interact with your product.
4. Robust
● What it means: Content must be robust enough to work across different platforms,
devices, and assistive technologies, and remain accessible as technologies evolve.
● Focus: Ensure compatibility with various screen readers, browsers, and devices. Use
semantic HTML and follow best practices for web development to create long-term
accessibility.
These four principles form the foundation of WCAG (Web Content Accessibility Guidelines)
and guide accessibility testing to ensure products are usable for people with diverse abilities.
GLOBAL RABBITS L.L.C. 6
Mastering Accessibility Reporting:
Identifying and Documenting Web
Accessibility Issues
Testing Tools
ANDI
ANDI (Accessible Name & Description Inspector) is a free open-source bookmarklet, meaning
that the tool does not require installation as a plugin and can be added to multiple browsers as a
bookmark.
ANDI is designed to help test web content for accessibility. Developed by the US Social Security
Administration, ANDI is available at [Link]
Colour Contrast Analyzer
The Colour Contrast Analyzer (CCA) is a free open-source tool that displays the contrast ratio
for two selected colors. Developed by Steve Faulkner and the Paciello Group (TPGi), CCA is
available at the following links:
• TPGi’s CCA download page
• CCA on GitHub
Microsoft’s Accessibility Insights (MSAI) has been validated as a substitute for CCA for the color
contrast test.
Operating Systems
The following operating systems were validated:
• Windows 10 and 11 (desktop mode)
• macOS (with Safari only)
Browsers
The following browsers were validated:
On Windows 10:
• Google Chrome
• Mozilla Firefox
• Microsoft Edge
On macOS:
• Safari
GLOBAL RABBITS L.L.C. 7
Mastering Accessibility Reporting:
Identifying and Documenting Web
Accessibility Issues
About Reports
To fill a report we are going to use a template across all our testing process, check the following
table:
Environment Fill here the environment you are testing on, E.g. Windows 11
Google Chrome Version 126.0.6478.182
Module Title Issue User Code Recom Compli Compli Screenshot
Impact referen mendat ance ance
ce ion Code
Exampl
e
Here should Summari Describe Describ Copy Here Use the Indicate Attach a
indicate the ze the the issue e wich and should code which screenshot
specific part or problem precisely, disable paste be a referenc complia highlighting the
component that in one add all the group is the written e and nce is element and the
are you testing, sentence examples being code of explana apply affected code in the DOM
E.g. “Header” where this affected the tion on necessa being affected
issue is by this element why this ry
happening issue that is is an change
and having issue s as an
how the and exampl
issue. how to e to fix
For fix it the
larger issue. In
codes the
you case of
should change
shorten s in
the design
nested or
element javascri
s with pt, an
(...) N/A is
used
We are going to look further about reports later.
GLOBAL RABBITS L.L.C. 8