The challenge

To ensure products used by the government are accessible, vendors must submit accessibility conformance reports (ACR) to demonstrate their products meet Section 508 requirements. The most commonly used ACR follows the Voluntary Product Accessibility Template (VPAT), a templated Word Document or PDF that software vendors fill in manually, and often is not an accurate representation of product accessibility.

The ACR process is inconsistently structured, not searchable, static, and with no version control. For this reason, providing more accessible services can be complex and disempowering for vendors and procurement officers. The General Services Administration (GSA), which manages and supports the basic functioning of federal agencies, was interested in finding ways to modernize the ACR process. After requesting a Market Research Request for Information (RFI), we responded with the concept for OpenACR, a tool that simplifies the process of finding, sharing, and maintaining accurate and actionable data about product accessibility. After GSA reviewed potential solutions, CivicActions was awarded the contract for our innovative approach.

Our Approach

Our team, led by Senior Strategist and accessibility expert Mike Gifford, realized that the process of managing ACRs hadn’t kept up with the nature of modern software development. Leveraging the YAML machine-readable language, the team created a highly structured report format that can be easily exported to an accessible and readable HTML document.

OpenACR, Open Source

Our team was excited to do the development process in the open. OpenACR is open source, so other organizations and members of the open source community are free to generate input and build on OpenACR’s source code. Subject Matter Experts (SMEs) worldwide have contributed to the development of this new tool, and all are welcome to visit the open issue queue to add feedback.

Foundational Accessibility

OpenACR sets a new standard for foundational accessibility. By building a machine-readable ACR, OpenACR allows for developing a central directory of accessibility standards for software used by the government. This is a significant milestone in standardizing accessibility practices and simplifies the process of communicating product accessibility for vendors and government IT buyers.

The challenge

Alternative text is a complex topic, as it is difficult to account for every possible scenario or to provide sufficient context for each image. However, in order for web pages to be the most accessible, any contextual images that have been added must include good quality, descriptive alt text. Our team was tasked with updating the image upload editorial interface within Drupal to help editors add better, more useful alt text for the images they were uploading.

We completed a full, cross-disciplinary project with our partners Friends From The City and Agile Six. The project included discovery to determine exactly which areas would be best to focus on, building a functional prototype for user research, and ultimately implementing improvements determined from that research to create a better, more informed user interface for Drupal editors.

Client goal

Our goal was to create a better alt text experience for Veterans visiting VA.gov. To achieve this we had to improve the user interface within Drupal to:

• Streamline and simplify the image upload form
• Clearly identify the alternative text field
• Add client-side validation for common errors seen within existing alt text
• Provide clear and concise error messages for editors to correct mistakes
• Educate editors on how to create descriptive and accurate alt text and why it is important

Building on Drupal, an open-source content management system (CMS), we wanted to improve the image upload editorial interface by implementing guardrails to prevent poor quality alt text through the enforcement of accessibility best practices while also reducing frustrations for CMS editors who are writing the alt text - ultimately resulting in better quality alternative text for people who rely on it to access visual content on VA.gov.

Our team worked cross functionally with our partners to explore solutions that were not only technically feasible, but also solved a variety of user needs by following human centered design practices. Research was a key component to improving the alt text on VA.gov, from gathering and analyzing statistics on current alt text to conducting user research sessions. The final design that was implemented was a direct result of iteration based on user feedback and thought partnership with our team and the product owners at the VA.

Determine which metrics to target

The current alt text for images within Drupal was evaluated based on multiple criteria - did the alt text contain a filename; was the alt text concise; was the alt text redundant; was the alt text accurate. The last criterion is very contextual, however the first three are more subjective and we decided to target those metrics to start focusing our improvements.

Identify Improvements

We created an interactive prototype to test with users. We analyzed the feedback from those research sessions to determine the best way to incorporate validation into the alt text field with the least amount of user disruption. We also determined additional user interface updates that would make the entire image upload experience a simpler and easier task for the editor.

Educate Drupal Editors

We created training articles within the Drupal Knowledge Base to help editors contextualize alt text and more fully understand what it is and why it is important. By helping editors understand the experience a Veteran might have if an image they upload has poor alt text, they will better understand the content they need to provide to improve this experience.

The challenge

The Georgia Board of Health Care Workforce (GBHCW) serves communities in the state with a focus on medically underserved areas. The agency provides data reports on the physician, physician assistant, and nurse workforce and funds loan repayment programs to recruit healthcare workers to underserved parts of the state. However, healthcare workforce planners were having trouble estimating and meeting demand for practitioners across counties --especially as the COVID-19 pandemic drew many of them out of Georgia and into various hotspot states. Additionally, without publicly-available data on healthcare workers, GBHCW struggled to inform medical facilities with potential funding and staffing needs."

The agency saw an opportunity to leverage the DKAN open data platform where they were already hosting their data, combined with custom data services from our team. We worked with GBHCW to create data visualizations and tools that make it easy for staff, medical practitioners, and the public to access the information needed to build a resilient and responsive state healthcare workforce.

Client goal

We were tasked with crafting detailed, easy-to-read visualizations for data provided by the Georgia Composite Medical Board and the Georgia Board of Nursing. We also built robust, multifunctional dashboards that allow data to be searched across physicians, physician assistants, and nurses. The dashboards needed to:

• Host and display data resources with user needs in mind
• Show the number of licensed healthcare practitioners in a given area
• Display data in a clear, user-friendly, and accessible way
• Be easily adaptable and sustainable with the constant influx of new data
• Reflect diverse intersections within the data (gender, race, qualifications, etc.)
• Help legislators make data-based decisions to improve the healthcare field

Our approach

Because other state agencies were already using the open source Drupal framework to publish and manage government content, GBHCW chose the Drupal-based open data platform DKAN for their data dashboards. The agency also saved time and money by utilizing an existing contract with us, adding new digital products to pre-built infrastructure.

As the core maintainers of DKAN, we provided research-based recommendations and custom data design and development services to make sure the dashboards solved the right problems for agency staff and stakeholders. The project was so successful that the client reached out to us with the intent to create more dashboards to display patient care and underserved areas data.

Build for real user needs

We brought a human-centered approach to the data dashboards, and used the React.js library to build intuitive visualizations. We listened carefully to the desired outcomes, researched user needs, then made suggestions for how people could best learn about the demographic makeup and overall distribution of physicians, physician assistants, and nurses throughout the state.

Deliver early and often

For the redesign of the data dashboards, we used agile sprint cycles with daily stand-up meetings to develop and implement small chunks of working software quickly. We used test data provided by GBHCW to create proofs-of-concept, with graphs and charts that made sense of the various elements we knew the client wanted to showcase.

Align and adapt

Meeting regularly with project leaders at the agency ensured that the vision and work remained in alignment. Together we reviewed work that had been done, checked if adjustments were needed, and responded quickly to evolving requests or new data. Staying in close communication ensured there were no surprises and the client goals were met.