jupyter / jupyter/notebook

Usability papercuts on keyboard shortcut help page

Open
#603 9 comments 0 reactions 0 assignees View on GitHub
help wanted tag:Design and UX
Dominant language
Jupyter Notebook
Stars
13.3k
Forks
5.8k
Avg merge
6d 11h
Merged PRs (30d)
7

Description

As a new user who was recently viewing the Notebook help page on keyboard shortcuts, I encountered two usability papercuts:
- The shortcuts are displayed with capital letters, but they are only activated by lowercase letters. At least, that's how things are on my Linux/Firefox setup. At first I thought nothing was working because I was typing (say) "A" instead of plain lowercase "a".
- The meaning of the comma syntax like "D, D" for "delete cell" is not at all clear. It took me a while to figure out that it meant I needed to press the keys twice.

Contributor guide

Open the contributing guide

Research direction

Start from the Notebook keyboard-shortcut help page and reproduce the examples in Linux/Firefox. Clarify lowercase activation and explain comma-separated repeated shortcuts such as “D, D”; done when the displayed guidance matches behavior and both ambiguities are resolved.

Written by the indexing model from the issue text.

Assessment

Tech stack
jupyter-notebook
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.