Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Screen Readers and Other Accessibility in Lessons

Abierto
#367 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
25/100
Tipo de issue
Documentación
Claridad
Necesita aclaración
Estado de actividad
Estancado
Stack tecnológico
jupyter-notebook

Línea de trabajo

Empieza probando Jupyter Notebooks con lectores de pantalla en PC, Linux y Chrome, comparando los resultados con el comportamiento informado de Safari y Firefox. Revisa las instructor notes como la ubicación propuesta para la documentación. Se considerará terminado cuando se hayan registrado los resultados de las pruebas y se haya resuelto si deben añadirse indicaciones específicas para cada navegador o instrucciones más amplias sobre accesibilidad.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Hi folks,

@Kswhitney raised a question on Twitter about Jupyter Notebooks and screen readers and how well they play together. I did some exploring on my Mac, and have not yet looked at PC yet (my office PC is being replaced, a months-long process for some reason).

Here's what I found:

  • When used with Safari, Jupyter Notebooks work quite well with the Mac screen reader app. The integration between the Mac screen reader and Safari is clearly a conscious design choice, and there is much finer-grained control of the reader's behavior in Safari.
  • When used with Firefox, they do not. These accessibility instructions appear to be out of date for the current FireFox.

Here is my proposal:

  • For now, recommend that Mac users who use a screen reader use Safari as the default web browser for Jupyter. We could add this as a note to the instructor notes. We could also add to the instructor notes instructions on setting Safari as the default browser for Jupyter.

What needs to be done:

  • Test this on PC. I assume FireFox will have similar issues there.
  • Test on Linux.
  • Test on Chrome.

My questions for y'all:

  • I feel out of my depth about what assistive technologies are actually being used. If anyone has some readings on what common ones are, I'd be happy to add them to the list o' things to test
  • I feel a little awkward breaking out of the browser agnosticism we've typically maintained. Is this OK? Is it noting the issue and suggesting a specific browser a sufficient solution?

Thanks, y'all, this is important stuff, and I hope we can come to some basic setup that will be workable for folks with this need.

Also tagging in @k8hertweck, since you expressed some interest in this.

Lenguaje dominante
Jupyter Notebook
Estrellas
176
Forks
316
Métricas de merge de PR
Sin PR fusionados en 30 d

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de datacarpentry/python-ecology-lesson

Todos los issues de datacarpentry/python-ecology-lesson

Issues similares

Más issues de Accessibility

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.