python / python/devguide

Audit accessibility of the devguide

オープン
#1,792 コメント 12 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

主要言語
Python
スター
2.1k
フォーク
1k
平均マージ
2日 12時間
マージ済み PR(30日)
12

説明

Audit our devguide for assistive tech and ARIA support.


From @hugovk:

Nice little shortcut, but I'm concerned this will interfere with keyboard handling for people using assistive tech such as screen readers.

https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/ includes:

So, screen reader users will commonly expect that pressing the right arrow key will expand a collapsed node.

https://webaim.org/techniques/keyboard/ has examples where / keys are needed.

Originally posted by @hugovk in https://github.com/python/devguide/issues/1784#issuecomment-4275849620

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

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

はじめの一歩

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

調査の方向性

まず、issue にリンクされている WAI-ARIA のキーボードインターフェースに関するガイダンスおよび WebAIM のキーボード例と照らし合わせて、devguide の関連するインタラクティブナビゲーションを確認します。アクセシビリティとキーボード処理の不足を特定し、その後、必要な変更を文書化または実装して、支援技術のユーザーが影響を受けるコントロールを操作できることを確認します。

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

評価

領域
accessibility, documentation
issue の種類
ドキュメント
難易度
4/5
見積もり時間
3〜5日
活発さ
静か
明瞭さ
説明が足りない
初心者へのやさしさ
42/100

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

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