Our DIESAT Tool Gets Automated Accessible PDFs
Our Disability Inclusive Employer Self-Assessment Tool is digitally accessible, but the PDFs with the results were not. We offered remediation upon request until Easy Surf fixed the issue altogether with an automated solution.
Introduction
We offer the Disability Inclusive Employer Self-Assessment Tool (DIESAT) for organizations to have a deeper understanding of a workplace’s current accessibility practices.
What was needed
We needed to ensure our dynamically generated PDF reports (generated by the answers in the self-assessment tool) were accessible for people with disabilities and usable across a wide range of assistive technologies. We didn’t realize there was a solution that didn’t require manual remediation of each PDF document.
Why was it needed
We want to lead by example to improve accessible digital communications. That meant ensuring our website, forms, and report outputs were accessible so people using any assistive technology could access the same information. We wanted our work to provide a roadmap that other employers could follow when generating content.
What we did
Easy Surf supported this by implementing an accessibility-led PDF generation tool, DocRaptor. This ensured each report was generated with correct structure, reading order, and semantics every time – meeting PDF/UA standards.
Accessible PDF generation
Semantic source content
The foundation of accessible PDF generation is accessible source content. Easy Surf worked with us to ensure that the HTML used to generate reports was fully semantic and meaningful before conversion.
As the website is hosted on WordPress and reliant on multiple plugins, this required careful coordination and consideration.
This included:
- Correct heading structure,
- Proper use of lists and links,
- Clear labelling of data and results,
- Logical reading order independent of visual layout.
By resolving accessibility issues at the source, we prevented them rather than patching later through remediating the documents.
Controlled HTML to PDF conversion
Easy Surf implemented a controlled HTML-to-PDF workflow using DocRaptor, ensuring accurate preservation of document structure during conversion.
This approach allowed:
- Headings to map correctly to PDF structure tags.
- Content to follow a predictable reading order.
- Consistent output across every generated report.
- Correct labelling of non-text content, such as images.
This allowed every PDF to be generated with unique content. Importantly, this removed reliance on manual fixes in PDF editors, which are time-consuming, error-prone, and difficult to scale.
Accessibility verification
Generated PDFs were reviewed to confirm that accessibility expectations were met in practice, not just in theory. Verification was completed through automated testing, manual code inspections, and, most importantly, testing by users with disabilities.
Verification focused on:
- Document structure and tagging,
- Logical reading order,
- Compatibility with assistive technologies,
- Predictable navigation through report content.
Any identified issues were traced to the source HTML or generation logic, ensuring fixes automatically improved all future reports.
A confident outcome
Because accessibility was addressed at the system level, our Disability Inclusive Employer Self-Assessment Tool can now generate unlimited PDF reports with confidence that accessibility is built-in and verified. This allows screen reader users, users with low vision, and users with cognitive disabilities to benefit most and improves outcomes for all users (including computers parsing the data!)
Accessible PDF generation is not just a formatting exercise but also an engineering decision. When accessibility is embedded upstream, organizations gain reliability, scalability, and confidence in their digital documents.
If you’re solving problems with PDFs or need your documents made accessible, we encourage you to reach out to Easy Surf!