Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

new navigation sidebar is effectively modal, keyboard-hostile, and hides the documentation from view

Ouverte
#81 17 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
35/100
Type d'issue
Bug
Clarté
Plutôt claire
Activité
À l'abandon
Stack technique
css
Domaine
accessibility, documentation

Piste de recherche

L’issue identifie la nouvelle barre latérale de navigation du thème de documentation de Python 3.10 et 3.11 ; commencez par localiser l’implémentation de cette barre latérale et reproduire son comportement à la souris et au clavier. Le travail sera considéré comme terminé si la documentation reste utilisable pendant la navigation, si la barre latérale ne masque pas le texte et si les utilisateurs du clavier peuvent accéder à la navigation et la faire défiler.

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

Description

The not-yet-released python 3.10 and 3.11 docs theme introduces navigation sidebar behavior that is several steps backwards in usability. From what I can tell, it exhibits all these problems:

  • When open, it covers up the documentation instead of letting the text reflow, making it impossible to follow my usual workflow of quickly jumping from one section to the next while reading the bits I need. The experience is like trying to navigate around modal dialog boxes in a 1990s Windows application.
  • It is now inaccessible on systems without a mouse.
  • Even on computers that have a mouse, viewing it is now a hassle. One must locate the mysterious hamburger button, move a hand to the mouse, aim it at the button, and click it, before the menu will appear at all. Only then can one go about looking for a needed navigation link. That's a lot of extra steps compared to simply having the links always available at the top, bottom, or side of the page.
  • Scrolling through the navigation links no longer works without a mouse. Page Up/Down, arrow keys, and space bar all fail to scroll the content being read. Only mouse navigation seems to be supported.

This new design seems to have been implemented hastily, without consideration for users outside a very narrow range of workflows and devices. Please revert it, at least until something more sensible can be developed.

Langage dominant
CSS
Étoiles
90
Forks
78
Merge moyen
2 j 19 h
PR mergées (30 j)
4

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.

Autres issues de python/python-docs-theme

Toutes les issues de python/python-docs-theme

Issues similaires

Plus d'issues Accessibility

Recevez les nouvelles issues par e-mail

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