How to generate a quote for ADA compliance
1. Overview
- This document serves as a guide for replying to Basecamp requests such as https://basecamp.com/1765618/projects/14413408/todos/443443748#comment:870095052
- This document is specifically made for auditing purposes only. If you need to access the developer’s guide, please see https://tripedia.thedesignpeople.net/qa/accessibility-guidelines-for-developers/ .
2. Get a list of URLs to be scanned
- Open Screaming Frog.
- Switch to List mode Screenshot .
- Click Download XML Sitemap Screenshot .
- Input the sitemap. The sitemap URL varies per website. Below are some examples:
- Click OK.
- Click Start.
- When Screaming Frog is done scanning the sitemap, click HTML Screenshot .
- Copy the URLs found by Screaming Frog.
3. Scan the URLs using pa11y
- pa11y is an application that scans the website for violations using HTML Code Sniffer’s guidelines. Its main advantage is that it allows us to scan URLs in bulk.
- Download the scanner .
- Follow the instructions under the One-time setup section.
- Follow the instructions under the Running the tester section. Paste the URLs you got from Screaming Frog to urls.txt.
- When pa11y is done scanning, you should see the results in output/output.csv.
4. Prepare the report
- Make a copy of https://docs.google.com/spreadsheets/d/1xpO/edit?usp=sharing .
- Manually identify the number of global issues. You can do this by opening a very basic inner page (e.g. about page) then counting the errors returned by HTML Code Sniffer. Put the total number in these cells (https://prnt.sc/17svgdi ).
Import
output/output.csv into a new sheet (https://www.loom.com/share/d7adc9977144cd6a546cf8a48945df ).- Copy and paste the data from the new sheet into the original one (https://www.loom.com/share/c34894863d35f14ad5bfd60cdbt1z15 ).
- Calculate the total (https://prnt.sc/17swxyz ).
- If there are iFramefinder or IDX Broker pages, exclude them from the total (https://prnt.sc/17sx736 ) .
5. See the final report
- https://docs.google.com/spreadsheets/d/1X5S1a6IfBu/ZeAwGfv+kr1i7pvat0WEFyA-qAfc14JTWvcfef6Kpg is a sample report.
- A site-wide report takes between 15 minutes to 1 hour to prepare depending on the number of URLs.
Last updated on