# Astronomy Notebooks for All

a media and software manufactory for disabled developer experiences.

![image.png](attachment:8ea12e8f-45e6-4ea6-a62b-e742e525774e.png)

<blockquote markdown cite="https://github.com/Iota-School/notebooks-for-all">
    
Jupyter Notebooks play a central role in modern data science workflows. Despite their importance, these notebooks are inaccessible to people with disabilities, especially those who rely on assistive technology. Impacted users must find extreme workarounds or [give up using them entirely.](https://www.freelists.org/post/program-l/Accessability-of-Jupyter-notebooks) Students with disabilities have [reported leaving their field](https://github.com/jupyterlab/jupyterlab/issues/9399#issuecomment-740524422) once they learn their chosen career’s foundational tools are inaccessible to them. 


[Space Telescope Science Institute](https://www.stsci.edu/) produces extensive community resources and infrastructure in Jupyter. The Institute has committed to fostering an inclusive environment and has funded this project in 2022-2023 as part of the Director’s Discretionary Fund. Other collaborators include community contributions and work from STEM- and accessibility-focused organizations such as [Iota School](https://iotaschool.com/) and [Quansight Labs](https://www.quansight.com/labs).

</blockquote>

## goal: start small to discover the needs of affected users


<blockquote markdown cite="https://github.com/Iota-School/notebooks-for-all">
This is a challenging problem to solve. The Notebooks for All project is taking the first steps, initially focusing on static notebooks: 

<ul>
    
<li>Running usability feedback sessions with impacted users who rely on a variety of assistive technology</li>
<li>Capturing what makes notebooks inaccessible with assistive technology, and compiling documents that describe the issues and feedback</li>
<li>Editing notebooks based on the feedback</li>
<li>Organizing events to spread awareness in the scientific community about this issue</li>
  
</uL>

</blockquote>

## result: unique open source design assets for iterative testing and reporting

![github issues from the notebooks for all repository that describe the lived experiences of disabled scientists.](attachment:0dd669d4-f608-4eb2-a26b-0640c2f2860c.png)

## events: accessible notebook hackathon

the first hands on auditting notebook event. focused time to explore auditing testing tools and accessibility features on your technologies. these events seeded the base for accessible notebook authoring guidelines.

recently, [venkatesh potluri](https://venkateshpotluri.me/) and myself hosted a [similar accessible notebook authoring events](https://tonyfast.github.io/tonyfast/xxiv/2024-03-01-notebook-accessibility-workshop.html#web-content-accessibility-guidelines-principles) at the [UW accessiblity + AI hackfest](https://create.uw.edu/calendar/ai-accessibility-hackfest/)

## events: stsci day of accessibility

[event agenda](https://iota-school.github.io/day_accessibility/)

![image.png](attachment:c8e2f6fe-ff7a-40f3-9e0e-98cf0d751f9c.png)

## talk: jupyter accessibility meeting

[Jenn and Erik visited a jupyter accessibility meeting in 2021](https://jupyter-accessibility.readthedocs.io/en/latest/community/meeting-minutes/jupyterlab-accessibility-meetings/2021/index.html?highlight=jenn#id52)

* Hello from Space Telescope Science Institute and Astropy!
* Jupyter notebooks aren’t accessible and we’d like them to be.
* We’ve been working with GLAS Education to test our own work with blind and visually impaired people.

## goal: retrofitting accessibility for computational is so hard

* [Accessibility Issues Needing Addressing for WCAG 2.1 compliance (As of Version 2.2.6) #9399](https://github.com/jupyterlab/jupyterlab/issues/9399)
* [Accessibility Issues Needing Addressing for WCAG 2.1 compliance (As of Version 7.0.0a15)](https://github.com/jupyter/notebook/issues/6800)

## event: jupyter workshops

## remediating nbconvert

`nbconvert` is a piece of technology that converts notebooks to html.

> how do we fix accessibiity if we don't know what accessible means?
> how do we improve the quality of tests with affected users?

## auditting chat interfaces

we turned our attention to [auditting LLM chat interfaces](https://huggingface.co/spaces/huggingchat/chat-ui/discussions/263). our prior research is practical in emerging interactive computing systems.

## events: monthly notebooks for all community meetings

the goal of these notebooks for all events to encourage more content made for and by disabled creators to push the needle on accessible open source.