Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add accessibility statement #3

Merged
merged 11 commits into from
Jun 20, 2022
84 changes: 84 additions & 0 deletions statement.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# JupyterLab Accessibility Statement

## Edited from the [W3C accessibility statement generator](https://www.w3.org/WAI/planning/statements/generator/#create)


## ⚠️ Draft Accessibility Statement for JupyterLab
isabela-pf marked this conversation as resolved.
Show resolved Hide resolved

This is an accessibility statement from <span class="basic-information organization-name">Jupyter accessibility contributors</span>.
trallard marked this conversation as resolved.
Show resolved Hide resolved

### Measures to support accessibility

Jupyter accessibility contributors take the following measures to ensure accessibility of JupyterLab:

* Include accessibility as part of our mission statement.
* Provide continual accessibility training for our community.
* Assign clear accessibility goals and responsibilities.
* Employ formal accessibility quality assurance methods.
trallard marked this conversation as resolved.
Show resolved Hide resolved

### Conformance status

The <a href="https://www.w3.org/WAI/standards-guidelines/wcag/">Web Content Accessibility Guidelines (WCAG)</a> defines requirements for designers and developers to improve accessibility for people with disabilities. It defines three levels of conformance: Level A, Level AA, and Level AAA. JupyterLab is non conformant with WCAG 2.1 level AA. Non conformant means that the content does not conform the accessibility standard.
trallard marked this conversation as resolved.
Show resolved Hide resolved

### Feedback

We welcome your feedback on the accessibility of JupyterLab. Please let us know if you encounter accessibility barriers on JupyterLab:
trallard marked this conversation as resolved.
Show resolved Hide resolved

* [Write an issue on jupyter/accessibility](https://github.com/jupyter/accessibility/issues/new)
* [Write an issue on jupyterlab/jupyterlab](https://github.com/jupyterlab/jupyterlab/issues/new) and request it be labeled [tag:accessibility](https://github.com/jupyterlab/jupyterlab/labels/tag%3AAccessibility)

### Compatibility with browsers and assistive technology

JupyterLab is designed to be compatible with the following technologies:

* Windows, macOS, iOS, Android; Firefox, Chrome, Safari, Chromium browsers (mobile and desktop).
trallard marked this conversation as resolved.
Show resolved Hide resolved

JupyterLab is not compatible with:

* Internet Explorer, Edge; JAWS, NVDA, VoiceOver, Narrator, Orca screen readers; voice control technology.

### Technical specifications

Accessibility of JupyterLab relies on the following technologies to work with the particular combination of web browser and any assistive technologies or plugins installed on your computer:

* HTML
* WAI-ARIA
* CSS
* JavaScript

These technologies are relied upon for conformance with the accessibility standards used.

### Limitations and alternatives

Despite our best efforts to ensure accessibility of JupyterLab, there may be some limitations. Below is a description of known limitations, and potential solutions. Please contact us if you observe an issue not listed below.

Known limitations for JupyterLab:
isabela-pf marked this conversation as resolved.
Show resolved Hide resolved

1. **Documents**: Documents writen by the community may not include accessible content because we do not and cannot review every document that can be opened in JupyterLab. To support accessible documents, we are drafting guidelines for accessible document content with an emphasis on Jupyter notebooks. Please report the issue to the author and [open an issue on jupyter/accessibility](https://github.com/jupyter/accessibility/issues/new) describing the problem and the behavior you expect so we may integrate it into our content guidelines.
trallard marked this conversation as resolved.
Show resolved Hide resolved
isabela-pf marked this conversation as resolved.
Show resolved Hide resolved

2. **JupyterLab extensions**: JupyterLab extensions writen by the community may not be accessible because JupyterLab extensions can be written by anyone in the community and have no required review process. We do not and can not review every JupyterLab extension. To support accessible extensions, we encourage extension authors to use existing, accessible JupyterLab components for their extension. We also provide periodic opportunities for community education on accessibility. Please report the issue to the author and let them know the [jupyter/accessibility](https://github.com/jupyter/accessibility/) community may be able to provide guidance.
isabela-pf marked this conversation as resolved.
Show resolved Hide resolved

### Assessment approach

Jupyter accessibility contributors assessed the accessibility of JupyterLab by the following approaches:

* Self-evaluation
* Regular automated testing to monitor for regressions (can be found at [jupyter/accessibility](https://github.com/jupyter/accessibility)
* User feedback</li>
isabela-pf marked this conversation as resolved.
Show resolved Hide resolved

### Evaluation report

An evaluation for JupyterLab is available at: [jupyterlab/jupyterlab/issues/9399](https://github.com/jupyterlab/jupyterlab/issues/9399).

### Evaluation report
trallard marked this conversation as resolved.
Show resolved Hide resolved
isabela-pf marked this conversation as resolved.
Show resolved Hide resolved

User reports on JupyterLab's accessibility are available at:[the jupyterlab/jupyterlab label `tag:accessibility`](https://github.com/jupyterlab/jupyterlab/labels/tag%3AAccessibility).

### Formal complaints
trallard marked this conversation as resolved.
Show resolved Hide resolved

* [Write an issue on jupyter/accessibility](https://github.com/jupyter/accessibility/issues/new)
trallard marked this conversation as resolved.
Show resolved Hide resolved
* [Write an issue on jupyterlab/jupyterlab](https://github.com/jupyterlab/jupyterlab/labels/tag%3AAccessibility) and request it be labeled tag:accessibility.
trallard marked this conversation as resolved.
Show resolved Hide resolved

### Date

This statement was created on 16 May 2022 using the [W3C Accessibility Statement Generator Tool](https://www.w3.org/WAI/planning/statements/).