python / python/devguide

Audit accessibility of the devguide

Ouverte
#1,792 12 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
Python
Étoiles
2.1k
Forks
1k
Merge moyen
2 j 12 h
PR mergées (30 j)
12

Description

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

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par examiner la navigation interactive pertinente du devguide au regard des recommandations de WAI-ARIA relatives aux interfaces clavier et des exemples de clavier de WebAIM liés dans l’issue. Identifiez les lacunes en matière d’accessibilité et de gestion du clavier, puis documentez ou implémentez les changements requis et vérifiez que les utilisateurs de technologies d’assistance peuvent utiliser les contrôles concernés.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Domaine
accessibility, documentation
Type d'issue
Documentation
Difficulté
4/5
Temps estimé
3-5 jours
Activité
Calme
Clarté
À clarifier
Accessibilité débutants
42/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.