hypothesis / hypothesis/product-backlog

Improve, expand, and document keyboard shortcuts

Open
#1,202 8 comments 0 reactions 0 assignees View on GitHub
accessibility feature request
Dominant language
No language data
Stars
122
Forks
7
PR merge metrics
No merged PRs in 30d

Description

Currently, users can annotate selected text by typing `a` to create an annotation or `h` to create a highlight. This meets WCAG guidelines but could use some improvement and new additions. For example:

- Enabling/disabling the browser extension
- Opening and closing the sidebar
- Moving from document to sidebar & vice versa
- Interacting with an annotation: Editing, Replying, Flagging, and Deleting
- Editing an annotation: toggle between preview and edit mode

Notes
- All of these commands should have some kind of modifier (CTRL or CMD). We should also ensure that these do not interfere with commonly used keyboard shortcuts in the browser or other assistive technology.
- Keyboard shortcuts should be documented in the KB

To Do:

- [ ] Make a list of "actions" someone would need to do within the app
- [ ] Propose a set of keyboard shortcuts for each of these options (might be helpful to research commonly used shortcuts to avoid)
- [ ] Meet with our contacts at Benetech to validate those suggestions
- [ ] Get this issue on our product backlog to be prioritized among our other work

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by turning the listed annotation, sidebar, extension, and navigation actions into a complete action list, then research browser and assistive-technology shortcut conventions. Validate proposed shortcuts with Benetech and record the resulting proposal in the product backlog; completion requires agreement on the shortcut set and documentation needs.

Written by the indexing model from the issue text.

Assessment

Domain
accessibility
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.