[DOCS] `/diff` detail view docs omit keyboard scrolling shortcuts
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/commands
Section/Topic
/diff command entry, especially the transition from the file list into the detail view
Current Documentation
The docs currently say:
/diff | Open an interactive diff viewer showing uncommitted changes and per-turn diffs. Use left/right arrows to switch between the current git diff and individual Claude turns, and up/down to browse files
The keyboard reference currently says:
Actions available in theDiffDialogcontext:diff:dismiss— Close diff viewerdiff:previousSource— Previous diff sourcediff:nextSource— Next diff sourcediff:previousFile— Previous file in diffdiff:nextFile— Next file in diffdiff:viewDetails— View diff details
What's Wrong or Missing?
Claude Code v2.1.149 added keyboard scrolling inside the /diff detail view, but the docs still stop at opening the detail view.
They do not tell readers that, once the detail view is open, they can scroll it with arrows, j/k, PgUp/PgDn, Space, and Home/End.
That leaves two gaps:
A. The /diff command docs describe only source switching and file navigation
Readers can see how to open the diff viewer and move between sources/files, but not how to navigate within a long diff after pressing Enter to open details.
B. The keyboard reference stops before detail-view scrolling behavior
The keybindings page shows how to enter the detail view, but it does not document the available scroll keys there or explain whether that detail view uses fixed keys or rebindable actions.
Suggested Improvement
Update the /diff documentation to include a short detail-view navigation note, for example:
PressEnterto open a file's detail view. In that view, use↑/↓orj/kto scroll line by line,PgUp/PgDnorSpaceto page, andHome/Endto jump to the beginning or end.
Also update the keyboard shortcut reference so the detail-view scrolling behavior is discoverable from the keybindings docs. If these keys map to rebindable actions, list those action names there; if they are fixed, note that explicitly.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 62 | /diff description covers source/file navigation only |
| https://code.claude.com/docs/en/keybindings | 246-258 | DiffDialog actions cover opening details, but not scrolling within the detail view |
Total scope: 2 pages affected
This gap became user-visible in changelog v2.1.149, which announces that the /diff detail view can now be scrolled with the keyboard.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗