This folder links to results from the 2022–2023 accessibility-focused usability tests on notebooks converted to HTML via nbconvert. This includes:
2022 August’s test 1 Results: Structure & Navigation in Rendered Notebooks. This document aggregates results describing the ways disabled participants navigated the notebook structure. It was designed to answer the question “How do users navigate and access different levels of structure within HTML outputs of Jupyter notebooks?”
2022 November-2023 January’s test 2 Results: Content Access in Rendered Notebooks. This document aggregates results of how accessible and comfortable working with different content types was for disabled participants. It was designed to answer the question " How are users able to access a range of commonly used content types within HTML outputs of Jupyter notebooks?"
The full list of user testing results and resources. This includes full test scripts and notebooks used per test.
Tests were conducted synchronously in small group settings on Zoom. All tests included one participant, one facilitator/meeting host, and one note taker. Participants were recruited via team member connections to disability and accessibility communities outside of Project Jupyter.
Background¶
As a part of ongoing efforts to understand the accessibility status of Jupyter projects and tools, Notebooks For All was made to evaluate and identify accessibility fixes for the Jupyter notebook-driven tutorial and documentation processes like those used by some public resources from the Space Telescope Science Institute. Because HTML converted notebooks as documentation is not an uncommon process in the wider community, this work and the issues raised apply to other projects and the default nbconvert templates more broadly. The full project proposal will be available on jupyter
The team initially connected over Jupyter accessibility meetings on the public Jupyter Community Calendar.
Credits¶
The Notebooks For All team includes Erik Tollerud (Space Telescope Science Institute), Isabela Presedo-Floyd (Quansight Labs), Jenn Kotler(Space Telescope Science Institute), Patrick Smyth (Iota School), and Tony Fast.
Usability testing was led by Jenn Kotler and Isabela Presedo-Floyd.