Skip to content

Commit a191238

Browse files
authored
Merge pull request #756 from github/jenndeforest-patch-1-3
Update accessibility.md based on audit
2 parents ef74953 + f135aa0 commit a191238

File tree

1 file changed

+39
-37
lines changed

1 file changed

+39
-37
lines changed

docs/accessibility.md

Lines changed: 39 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -9,25 +9,25 @@ data:
99
product:
1010
criteria:
1111
- criterion: "Section 1194.21 Software Applications and Operating Systems"
12-
support: Supports
13-
comments: GitHub.com, GitHub Enterprise, GitHub Desktop
12+
support: Supports with exceptions
13+
comments:
1414
- criterion: "Section 1194.22 Web-based Intranet and Internet Information and Applications"
1515
support: Supports with exceptions
16-
comments: GitHub.com and GitHub Enterprise
16+
comments:
1717
- criterion: "Section 1194.23 Telecommunications Products"
1818
support: Not applicable
1919
comments:
2020
- criterion: "Section 1194.24 Video and Multi-media Products"
21-
support: Supports
22-
comments: "Training materials available via [youtube.com/github](https://www.youtube.com/user/github) and [youtube.com/githubguides](https://www.youtube.com/user/githubguides)"
21+
support: Supports with exceptions
22+
comments:
2323
- criterion: "Section 1194.25 Self-Contained, Closed Products"
2424
support: Not applicable
2525
comments:
2626
- criterion: "Section 1194.26 Desktop and Portable Computers"
2727
support: Not applicable
2828
comments:
2929
- criterion: "Section 1194.31 Functional Performance criterion"
30-
support: Supports
30+
support: Supports with exceptions
3131
comments:
3232
- criterion: "Section 1194.41 Information, Documentation and Support"
3333
support: Supports
@@ -37,41 +37,43 @@ data:
3737
product: GitHub.com, GitHub Enterprise, GitHub Desktop
3838
criteria:
3939
- criterion: "(a) When software is designed to run on a system that has a keyboard, product functions shall be executable from a keyboard where the function itself or the result of performing a function can be discerned textually."
40-
support: Supports
41-
comments:
40+
support: Supports with exceptions
41+
comments: The items inside of Assignees and Clear Assignees require a user to tab to the submenu items versus use down/up arrows.<br /><br />Labels option does not follow typical keyboard actions.<br /><br />In Desktop for Windows and Mac, “Close” button control does not have close option in the keyboard tab order. User has to hit Esc key to cancel changes.<br /><br />On Desktop for Windows, context menus key off of the mouse versus the parent control.<br /><br />On Desktop for Windows and Mac, the Co-Author button is not keyboard navigable.
4242
- criterion: "(b) Applications shall not disrupt or disable activated features of other products that are identified as accessibility features, where those features are developed and documented according to industry standards. Applications also shall not disrupt or disable activated features of any operating system that are identified as accessibility features where the application programming interface for those accessibility features has been documented by the manufacturer of the operating system and is available to the product developer."
4343
support: Supports
4444
comments: GitHub desktop applications are built using platform-specific standards and best practices where possible.
4545
- criterion: "(c) A well-defined on-screen indication of the current focus shall be provided that moves among interactive interface elements as the input focus changes. The focus shall be programmatically exposed so that Assistive Technology can track focus and focus changes."
46-
support: Supports
47-
comments:
46+
support: Supports with exceptions
47+
comments: The Filter control on the web client does not receive keyboard focus.<br /><br />When changing color value on Labels button, focus unexpectedly moves to top of page.<br /><br />When activating certain controls such as “delete” button for labels and links from buttons, expanded filters or filtered search results, focus does not move to the new dialog.<br /><br />When creating a “new issue,” focus does not move automatically to the title field.<br /><br />Focus order when creating a “new issue” is not logical.<br /><br />Focus does not go to user name/repo name, when activating "Skip to Main" button.<br /><br />In GitHub Notifications page, notifications are read out of logical order.<br /><br />When activating the branch dropdown menu, focus is not visible on “Skip to Content” link.<br /><br />On the Windows Desktop client, focus does not move to the first actionable item after sign in.<br /><br />On Desktop for Mac, add co-authors button is not keyboard focusable and focus is not visible on comments section.
4848
- criterion: "(d) Sufficient information about a user interface element including the identity, operation and state of the element shall be available to Assistive Technology. When an image represents a program element, the information conveyed by the image must also be available in text."
49-
support: Supports
50-
comments:
49+
support: Supports with exceptions
50+
comments: For web and GitHub client experiences, when making an edit to the markdown of the GitHub ReadMe file, the field is not announced as editable and “no new line at end of file” icon is not announced by screen reader.<br /><br />Across a number of areas in the GitHub Marketplace and Desktop for Windows and Mac experiences, selected elements are not announced as selected and decorative elements are not skipped by screen readers.<br /><br />Throughout GitHub sites and Desktop client experiences, links are only described as links without additional context. For example, in GitHub repositories, new links are described only as new link without additional context. Social media links (e.g., GitHub Twitter link) are only described as “link.”<br /><br />Assignees button, and type or choose name control do not have the correct accessible control name.<br /><br />No additional announcements are made after making a pull request although there are visual displays of errors and other information.<br /><br />On web experiences and Desktop for Windows, when reviewing search results data, checkboxes for labels and select all issues checkboxes do not have accessible names.<br /><br />On GitHub Help page, search button does not have the control type described.<br /><br />On GitHub Repo Settings Collaborators, the dismiss message button is announced before message is read and “Delete this repository” dialog sets focus to input field and ignores accompanying text.<br /><br />When not signed in, button names are not read (such as Watch or Fork) and instead, you must be signed in is read when landing on the control.<br /><br />On Desktop for Windows, default branch, recent branch and other branch headings are not announced by screen readers.<br /><br />On Desktop for Mac, when using delete branch button, the button state change to “restore branch” is not announced.<br /><br />On Desktop for Windows, Continue dialog and Finish button do not trigger focus change to new dialogs when activated.<br /><br />On Desktop for Windows, Co-Author edit box does not have an accessible name.<br /><br />On Desktop for Windows and Mac, when when using “Fetch Origin” button and “Publish” button additional information when button state changes (e.g., fetch origin never fetched) is not announced by screen reader.<br /><br />On Desktop for Windows and Mac, new lines of code are announced as buttons.<br /><br />On Desktop for Windows, file viewer control does not have an accessible name.<br /><br />On Desktop for Windows and Mac the blue dot indicating status message on history is not announced.
5151
- criterion: "(e) When bitmap images are used to identify controls, status indicators, or other programmatic elements, the meaning assigned to those images shall be consistent throughout an application's performance."
5252
support: Supports
5353
comments: "All iconography are rendered via the [Octicons](https://octicons.github.com/) library."
5454
- criterion: "(f) Textual information shall be provided through operating system functions for displaying text. The minimum information that shall be made available is text content, text input caret location, and text attributes."
5555
support: Supports
5656
comments:
5757
- criterion: "(g) Applications shall not override user selected contrast and color selections and other individual display attributes."
58-
support: Supports
59-
comments: System wide contrast, font-size and other accessibility preferences are respected throughout the application.
58+
support: Supports with exceptions
59+
comments: System wide contrast, font-size and other accessibility preferences are respected throughout the application except the Desktop for Mac client does not respond to high contrast settings.
6060
- criterion: "(h) When animation is displayed, the information shall be displayable in at least one non-animated presentation mode at the option of the user."
61-
support: Not applicable
61+
support: Supports
6262
comments:
6363
- criterion: "(i) Color coding shall not be used as the only means of conveying information, indicating an action, prompting a response, or distinguishing a visual element."
64-
support: Supports
65-
comments: Visual line diffs are annotated with standard "+" and "-" notation to indicated additions and removals
64+
support: Supports with exceptions
65+
comments: Visual line diffs are annotated with standard “+” and “-“ notation to indicated additions and removals, but may not be available to screen readers on Desktop for Windows and Mac clients.
6666
- criterion: "(j) When a product permits a user to adjust color and contrast settings, a variety of color selections capable of producing a range of contrast levels shall be provided."
67-
support: Not applicable
67+
support: Supports
6868
comments:
6969
- criterion: "(k) Software shall not use flashing or blinking text, objects, or other elements having a flash or blink frequency greater than 2 Hz and lower than 55 Hz."
7070
support: Supports
71-
comments: Applications have no flashing or blinking elements
71+
comments: Applications have no flashing or blinking elements.
7272
- criterion: "(l) When electronic forms are used, the form shall allow people using Assistive Technology to access the information, field elements, and functionality required for completion and submission of the form, including all directions and cues."
73-
support: Supports
74-
comments:
73+
support: Supports with exceptions
74+
comments: When making an edit to the markdown of the GitHub ReadMe file, the field is not announced as editable.<br /><br />No additional announcements are made after making a pull request although there are visual displays of errors and other information.<br /><br />Assignees button and “Type or choose a name edit field” have accessible names that do not match the visual control names.<br /><br />Input errors on GitHub.com sign up and sign-in pages on Desktop for Windows and Mac are not announced.
75+
76+
7577

7678
"Section 1194.22 Web-based Intranet and Internet Information and Applications":
7779
product: GitHub.com and GitHub Enterprise
@@ -95,8 +97,8 @@ data:
9597
support: Not applicable
9698
comments: No client-side image maps are used.
9799
- criterion: "(g) Row and column headers shall be identified for data tables."
98-
support: Supports
99-
comments:
100+
support: Supports with exceptions
101+
comments: GitHub Enterprise dashboard has a table that is not identified as a data table.
100102
- criterion: "(h) Markup shall be used to associate data cells and header cells for data tables that have two or more logical levels of row or column headers."
101103
support: Not applicable
102104
comments:
@@ -114,16 +116,16 @@ data:
114116
comments:
115117
- criterion: "(m) When a web page requires that an applet, plug-in or other application be present on the client system to interpret page content, the page must provide a link to a plug-in or applet that complies with 1194.21(a) through (l)."
116118
support: Not applicable
117-
comments: The only plugin used is a flash-based tool for simplifying the task of copying text visible on the page (such as a commit's unique id) to the user's clipboard. The task may be accomplished through the operating system's standard copy and paste functionality.
119+
comments: The only plugin used is a flash-based tool for simplifying the task of copying text visible on the page (such as a commits unique id) to the users clipboard. The task may be accomplished through the operating systems standard copy and paste functionality.
118120
- criterion: "(n) When electronic forms are designed to be completed on-line, the form shall allow people using Assistive Technology to access the information, field elements, and functionality required for completion and submission of the form, including all directions and cues."
119121
support: Supports
120122
comments:
121123
- criterion: "(o) A method shall be provided that permits users to skip repetitive navigation links."
122-
support: Supports
123-
comments:
124+
support: Supports with exceptions
125+
comments: On GitHub Enterprise and the GitHub Desktop client, the user must tab through repetitive links as there is no skip to main content.
124126
- criterion: "(p) When a timed response is required, the user shall be alerted and given sufficient time to indicate more time is required."
125127
support: Not applicable
126-
comments: No timed responses are required.
128+
comments: Timed responses are not required.
127129

128130
"Section 1194.23 Telecommunications Products":
129131
product:
@@ -184,8 +186,8 @@ data:
184186
support: Supports
185187
comments: "Training materials available at [youtube.com/github](https://www.youtube.com/user/github) and [youtube.com/githubguides](https://www.youtube.com/user/githubguides). All GitHub videos are fully closed captioned. <br /><br />For more information on YouTube's accessibility see [support.google.com/youtube/answer/189278](https://support.google.com/youtube/answer/189278?hl=en)"
186188
- criterion: "(d) All training and informational video and multimedia productions which support the agency's mission, regardless of format, that contain visual information necessary for the comprehension of the content, shall be audio described."
187-
support: Supports
188-
comments:
189+
support: Supports with exceptions
190+
comments: Training videos posted via YouTube video player do not include audio description.
189191
- criterion: "(e) Display or presentation of alternate text presentation or audio descriptions shall be user-selectable unless permanent."
190192
support: Supports
191193
comments: Viewers may toggle closed captioning using YouTube's native closed-captioning functionality.
@@ -253,23 +255,23 @@ data:
253255
product:
254256
criteria:
255257
- criterion: "(a) At least one mode of operation and information retrieval that does not require user vision shall be provided, or support for Assistive Technology used by people who are blind or visually impaired shall be provided."
256-
support: Supports
257-
comments: All Git-based file operations can be performed via the text-only Git command line interface using assistive technology, and all account management and social interactions (e.g., commenting on an issue) can be performed via GitHub.com or GitHub enterprise with assistive technology.
258+
support: Supports with exceptions
259+
comments: Account management and social interaction scenarios for each of the GitHub offerings covered by this VPAT have focus order, name, role, value, accessible name, and info and relationship issues that may prevent some scenarios from being completed.
258260
- criterion: "(b) At least one mode of operation and information retrieval that does not require visual acuity greater than 20/70 shall be provided in audio and enlarged print output working together or independently, or support for Assistive Technology used by people who are visually impaired shall be provided."
259-
support: Supports
260-
comments: All GitHub product support the use of assistive technology and provide the ability, through the user's web browser or operating system to increase the font size.
261+
support: Supports with exceptions
262+
comments: Zooming to certain levels will cause info on the screen to be pushed off and require horizontal scrolling. This is particularly impactful when accessing GitHub web offerings or experiences on mobile devices.<br /><br />For each of the GitHub offerings covered by this VPAT, there is insufficient color contrast on a number of links, dialogs and controls.
261263
- criterion: "(c) At least one mode of operation and information retrieval that does not require user hearing shall be provided, or support for Assistive Technology used by people who are deaf or hard of hearing shall be provided"
262264
support: Supports
263-
comments: Products do not use auditory feedback.
265+
comments: Products do not require auditory feedback.
264266
- criterion: "(d) Where audio information is important for the use of a product, at least one mode of operation and information retrieval shall be provided in an enhanced auditory fashion, or support for assistive hearing devices shall be provided."
265267
support: Not Applicable
266268
comments: Products do not use auditory feedback.
267269
- criterion: "(e) At least one mode of operation and information retrieval that does not require user speech shall be provided, or support for Assistive Technology used by people with disabilities shall be provided."
268270
support: Supports
269-
comments: Products do not support speech input.
271+
comments: Products do not require speech input.
270272
- criterion: "(f) At least one mode of operation and information retrieval that does not require fine motor control or simultaneous actions and that is operable with limited reach and strength shall be provided."
271-
support: Supports
272-
comments: No interactions require simultaneous user actions or depend solely on fine motor controls.
273+
support: Supports with exceptions
274+
comments: Submenus and other control areas may require using irregular keyboard actions such as tabbling versus up/down arrows and focus order for creating and managing issues in GitHub is illogical.
273275

274276
"Section 1194.41 Information, Documentation and Support":
275277
product:

0 commit comments

Comments
 (0)