You are currently reviewing an older revision of this page.

DRAFT SP-4176 How to report accessibility violations

Purpose

Appian allows designers to build applications that are accessible to all users, and validates its product features against the requirements of leading accessibility standards:

Given Appian's established accessibility conformance (with some exceptions), all submitted violations must be validated by the assessor prior to submission. Appian does not accept unvalidated results or direct output from automated scanners without additional validation. After the violation behavior has been manually tested, appropriate verification must be provided in a support case as specified in the Instructions section below. This ensures Appian has a thorough understanding of the violation being encountered so that we can compare it to expected behavior and determine the platform changes (if any) that need to be made to meet accessibility standards.

Note that for issues involving accessibility tools like screen readers, the issue MUST be encountered when using a screen reader. Many automated tests report accessibility violations based on the HTML code. However, an issue with the HTML does not always cause an issue with the screen reader.

When in doubt about whether a violation is valid, consider whether it impacts the understanding of the page for the following accessibility user groups:

  • Visually compromised users who rely on screen readers or require resized text
  • Manually compromised users who rely on keyboards to tab through each page

Instructions

For each violation, provide:

  1. Impacted browser(s) and accessibility tool version(s).
  2. The specific WCAG success criterion that is being violated in the Web Content Accessibility Guidelines linked above.
  3. At least one of the following based on applicability:
    1. A video capture (with audio) of the screen reader interacting with the object. Since it is not realistic for Appian to conform to all screen readers on the market, the following must be used:
      1. JAWS for Internet Explorer 11
      2. NVDA for Firefox
    2. The HTML of the page containing the object
    3. The SAIL of the page containing the object
  4. Whether the violation is a requirement or an advisory (recommendation) based on the success criterion details.
  5. (On-premise-only) The version and hotfix for the affected site, since some issues have been resolved in specific hotfixes.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2020