Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Screen Readers and Other Accessibility in Lessons

オープン
#367 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
25/100
issue の種類
ドキュメント
明瞭さ
説明が足りない
活発さ
停滞
技術スタック
jupyter-notebook

調査の方向性

まず、PC、Linux、Chromeでスクリーンリーダーを使ってJupyter Notebooksをテストし、結果を報告されているSafariとFirefoxの挙動と比較します。提案されているドキュメントの場所として、instructor notesを確認します。テスト結果を記録し、ブラウザー固有のガイダンスを追加するべきか、より広範なアクセシビリティ手順を追加するべきかを解決できれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
Jupyter Notebook
スター
176
フォーク
316
PR マージ指標
30日以内にマージされた PR はありません

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

datacarpentry/python-ecology-lesson のほかの issue

datacarpentry/python-ecology-lesson の issue をすべて見る

似ている issue

Accessibility の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。