Accessibility

Firely Accessibility Conformance Report - WCAG Edition

(Based on VPAT® Version 2.4)

Name of Product/Version: Simplifier.net

Report Date: 22-12-2020

Product Description: Simplifier.net by Firely is an online platform for collaborating on, and publishing the artifacts from, FHIR specifications.

Contact Information: Please contact simplifier@fire.ly with any questions or suggestions for improvements.

Notes

General notes

• Simplifier.net is a platform for user-generated content. While we do our best to facilitate our users in creating accessible content, the flexibility of the platform requires users to check their own generated content for accessibility.

• The tree rendering of FHIR resources can be navigated by keyboard when Javascript is enabled:

  • Tab until the full three is selected.

  • Then navigate the three rows with the up and down arrows. When using a screen reader this can be done after ‘Scan mode’ is turned off.

  • Three nodes can be opened/collapsed by selecting the node and pressing Space bar or Enter.

  The Details page on a resource and dictionary rendering in an Implementation Guide provide static alternatives.

• The Monaco Editor which is embedded in many places on the site provides powerfull accessibility features and a dedicated menu which is highlighted when using a screen reader. More information can be found in the Monaco Editor Accessibility Guide.

Changelog

• Nov 30, 2020: First edition published.

• Dec 22, 2020: Accessibility scan completed and major issues resolved.

Evaluation Methods Used

• Testing based on general product knowledge

• Testing with assistive technologies with Google Chrome/Microsoft Edge on Windows

  • WAVE Web Accessibility Evaluation Tool

  • Microsoft Narrator

Applicable Standards/Guidelines

This report covers the degree of conformance for the following accessibility standard/guidelines:

Standard/Guideline	Included In Report
Web Content Accessibility Guidelines 2.0	Level A: Yes Level AA: Yes Level AAA: No
Web Content Accessibility Guidelines 2.1	Level A: Yes Level AA: Yes Level AAA: No

Terms

The terms used in the Conformance Level information are defined as follows:

• Supports : The functionality of the product has at least one method that meets the criterion without known defects or meets with equivalent facilitation.

• Partially Supports : Some functionality of the product does not meet the criterion.

• Does Not Support : The majority of product functionality does not meet the criterion.

• Not Applicable : The criterion is not relevant to the product.

• Not Evaluated : The product has not been evaluated against the criterion. This can be used only in WCAG 2.0 Level AAA.

Scope

Tests were executed with the following pages, taken as representative for the full application:

Id	Web Page / Screen / Document Identifier	Location / URL
1	Implementation Guide	https://simplifier.net/guide/accessibilitytestingimplementationguide
1.1	Home page and navigation	https://simplifier.net/guide/AccessibilitytestingImplementationGuide/Home
1.2	Static Markdown pages	https://simplifier.net/guide/accessibilitytestingimplementationguide/staticmarkdownpage
1.3	Page with an embedded resource	https://simplifier.net/guide/accessibilitytestingimplementationguide/pagewithanembeddedresource
2	Resource page	https://simplifier.net/Accessibilitytestingproject/ACMEbasePatient
2.1	Page with tree view	https://simplifier.net/Accessibilitytestingproject/ACMEbasePatient/~overview
3	Home page	https://simplifier.net/
4	Organization page	https://simplifier.net/organization/firely
5	Project page	https://simplifier.net/accessibilitytestingproject
6	Package page	https://simplifier.net/packages/firely.com.accessibilitytesting/0.0.1-test/~introduction
7	Validation page	https://simplifier.net/snippet/wardweistra/18/$validate
8	Search page	https://simplifier.net/search (Postponed until after upcoming redesign)
9	Snippet page	https://simplifier.net/snippet/wardweistra/18
10	Documentation page	https://docs.fire.ly/simplifier/index.html

WCAG 2.x Report

Note: When reporting on conformance with the WCAG 2.x Success Criteria, they are scoped for full pages, complete processes, and accessibility-supported ways of using technology as documented in the WCAG 2.0 Conformance Requirements.

Table 1: Success Criteria, Level A

Criteria	Conformance Level	Remarks and Explanations
1.1.1 Non-text Content (Level A)	Supports	Resolved issues: On Firely Docs DevDays banner has no alt text, search bar no form label [SIM-1403] Add alt text to home page images
1.2.1 Audio-only and Video-only (Level A)	Supports	No audio or video content is used.
1.2.2 Captions (Level A)	Supports	No audio or video content is used.
1.2.3 Audio Description or Media Alternative (Level A)	Supports	No audio or video content is used.
1.3.1 Info and Relationships (Level A)	Supports	Sections are labeled with relevant ARIA tags.
1.3.2 Meaningful Sequence (Level A)	Supports	Meaningful order of elements is reflected in programmatic page structure.
1.3.3 Sensory Characteristics (Level A)	Supports	Instructions provided for understanding and operating content do not rely solely on sensory characteristics of components such as shape, size, visual location, orientation, or sound.
1.4.1 Use of Color (Level A)	Supports	Color is not used as the only visual means of conveying information, indicating an action, prompting a response, or distinguishing a visual element.
1.4.2 Audio Control (Level A)	Supports	No audio is used.
2.1.1 Keyboard (Level A)	Partially Supports	For keyboard navigation in the FHIR resource tree and the embedded Monaco code editors, see general notes above. Resolved issues [SIM-1355] Feedback button is not accessible by tab [SIM-1358] Hide visually hidden menu items from project/resource menu for screen readers [SIM-1357] Alternative for/navigate by keyboard resource tree [SIM-1401] Keyboard navigation for instance tree [SIM-1397] Can’t reach diff/hybrid/snapshot button with tab [SIM-1359] In IG editor > IG settings: Can’t change tab with keyboard [SIM-1406] Can’t reach certain menu items using tab on Organization and Snippet page [SIM-1388] Subscribe menu item on project/resource page not accessible by keyboard navigation Known issues [SIM-1382] Edit button for canonical base URLs on project not accessible with keyboard only [SIM-1384] Can’t activate the checkmarks on the Create a new package page
2.1.2 No Keyboard Trap (Level A)	Partially Supports	On tab trapping in the embedded Monaco code editors, see general note above. Resolved issues [SIM-1354] The code editor for project settings is a keyboard trap and needs to be replaced with code editor used elsewhere. [SIM-1380] keyboard trap: manage dependencies on project, search field [SIM-1379] keyboard trap: create new package, release notes field Known issues [SIM-1378] keyboard trap: create issue on project / add comment on issue [SIM-1381] keyboard trap: create script connector
2.1.4 Character Key Shortcuts (Level A 2.1 only)	Supports	No keyboard shortcuts are used, except in Monaco code editor, which provides its own accessibility menu and options.
2.2.1 Timing Adjustable (Level A)	Supports	No timings are used.
2.2.2 Pause, Stop, Hide (Level A)	Supports	All scrolling, moving content (for example the log output from file import or package generation) are started based on user input and pause at the end for review.
2.3.1 Three Flashes or Below Threshold (Level A)	Supports	No flashing content is used.
2.4.1 Bypass Blocks (Level A)	Supports	Resolved issues [SIM-1365] Make it easier to skip to main content by providing ARIA indications for blocks.
2.4.2 Page Titled (Level A)	Supports	Resolved issues [SIM-1366] Reverse page title order: Content for repeated SIMPLIFIER.net Known issues [SIM-1367] Consider using different page title per resource/project/package tab
2.4.3 Focus Order (Level A)	Supports	Resolved issues [SIM-1358] Put project/package/resource menu in right tab order. [SIM-1358] Main buttons of project/package/resource menu are not selectable
2.4.4 Link Purpose (In Context) (Level A)	Supports	Resolved issues: [SIM-1411] Validation page has nondescriptive links [SIM-1369] Better text around Avatar image/link
2.5.1 Pointer Gestures (Level A 2.1 only)	Partially Supports	Known issues: [SIM-1371] Drag and drop for page reordering in IG editor has no keyboard/button alternative [SIM-1387] Unable to succesfully navigate account avatar with keyboard only
2.5.2 Pointer Cancellation (Level A 2.1 only)	Supports	No actions are executed on mouse down event.
2.5.3 Label in Name (Level A 2.1 only)	Supports
2.5.4 Motion Actuation (Level A 2.1 only)	Supports	No motion is used.
3.1.1 Language of Page (Level A)	Supports	Resolved issues [SIM-1372] Define English as the language for every Simplifier page
3.2.1 On Focus (Level A)	Supports	No change of context is executed when changing focus.
3.2.2 On Input (Level A)	Supports	No change of context is executed when changing input, without user actuation.
3.3.1 Error Identification (Level A)	Partially Supports	Known issues [SIM-1373] Error message on deleting team with packages/project linked is time based [SIM-1413] Incorrect URL message on Account settings page is time based Confirmation of copied canonical or resource is time based popup
3.3.2 Labels or Instructions (Level A)	Supports	Resolved issues [SIM-1374] No label for main search bar on home page and search bar on other pages
4.1.1 Parsing (Level A)	Partially Supports	Resolved issues [SIM-1398] Broken ARIA menu in Avatar drop down menu [SIM-1399] Broken ARIA menu in resource settings menu item [SIM-1400] Broken ARIA menus in project [SIM-1416] Broken ARIA menus in Signup page and Home signup form [SIM-1386] W3 Validator reports errors on certain pages. Known issues [SIM-1389] Tree rendering HTML errors
4.1.2 Name, Role, Value (Level A)	Partially Supports	Resolved issues [SIM-1368] Buttons without text: Copy button next to API link, Canonical link, (embed) Snippet URL, etc. Known issues [SIM-1384] Check boxes on package creation third tab are not tab accessible.

Table 2: Success Criteria, Level AA

Criteria	Conformance Level	Remarks and Explanations
1.2.4 Captions (Live) (Level AA)	Supports	No (live) audio used.
1.2.5 Audio Description (Prerecorded) (Level AA)	Supports	No video content used.
1.3.4 Orientation (Level AA 2.1 only)	Supports	Site does not fixate a particular screen orientation.
1.3.5 Identify Input Purpose (Level AA 2.1 only)	Partially Supports	Known issues [SIM-1376] Use standard input type on Signup, Login and Account Settings (eg type=name)
1.4.3 Contrast (Minimum) (Level AA)	Partially Supports	On constrast in the embedded Monaco code editors, see general note above. Contrast issues on website header and footer and Implementation Guides footer have been resolved [SIM-1377]. Contrast issues in website main content will be addressed in upcoming change of website colors.
1.4.4 Resize text (Level AA)	Supports	No loss of function at 200% zoom level.
1.4.5 Images of Text (Level AA)	Supports	No images of text are used.
1.4.10 Reflow (Level AA 2.1 only)	Supports	Even in small view ports website reflows and content is still accessible.
1.4.11 Non-text Contrast (Level AA 2.1 only)	Supports	Images not used as replacement for user interface components or for required understanding.
1.4.12 Text Spacing (Level AA 2.1 only)	Supports	No loss of function found with large fonts, line height and spacing.
1.4.13 Content on Hover or Focus (Level AA 2.1 only)	Supports	Note: For seeing the content that appears in the resource tree-rendering on mouse over, click the element to make it persistent and not disappear on removal of mouse focus.
2.4.5 Multiple Ways (Level AA)	Supports	All user content on Simplifier.net is reachable via Search and direct navigation via owning organization/project/packages. Implementation Guides have support for providing a Table of Contents of all pages.
2.4.6 Headings and Labels (Level AA)	Supports	Resolved issues [SIM-1396] Make tabs on resource/project/etc. page headings and indicate active state [SIM-1405] Feedback popup is missing label and has orphaned label [SIM-1408] Missing form labels and empty buttons on Project page
2.4.7 Focus Visible (Level AA)	Supports	Resolved issues [SIM-1356] Avatar shows no visible indication of being selected with tab
3.1.2 Language of Parts (Level AA)	Supports	Website is only provided in English, which is indicated as page language. Note: User defined text currently has no way to deviate from English language. This will be done later when support for IG translation is added.
3.2.3 Consistent Navigation (Level AA)	Supports	The menu is provided consistently throughout the site. Exceptions: Full page editors that open in new window: Differential in resource history, Update resource in standalone editor, Implementation Guide editor. Implementation guides have a navigation defined by the style chosen by the publishing user.
3.2.4 Consistent Identification (Level AA)	Supports
3.3.3 Error Suggestion (Level AA)	Supports	Where solutions to possible errors are known the site tries to prevent you from making them beforehand. Examples: Providing dropdowns of possible values or automatically fixing duplicate URLs.
3.3.4 Error Prevention (Legal, Financial, Data) (Level AA)	Supports	No financial transactions, legal transactions or test results are handled. All data delete operations require an extra confirmation step.
4.1.3 Status Messages (Level AA 2.1 only)	Supports	There where status is conveyed by graphical elements, like a progress bar, the status is programmatically available to the user agent.