Discussions
The Discussion tab lists every comment thread on a review as a card. The diff shows threads next to their lines; this tab shows all of them in one scrollable list. Press 4 from any review to open it.
Discussion cards
Section titled “Discussion cards”Each card shows:
- the file and line for an inline thread, or
[general]for a thread on the whole review - the reply count and when the thread started
- a few lines of the diff around an inline thread, with the commented line marked
- the whole thread, each comment with its author and rendered as Markdown
- the keys that apply to it, including Resolve or Unresolve when the forge allows resolving that thread
Open threads come first, sorted by file and line. General threads follow the inline ones, and resolved threads come last, dimmed.
Navigation
Section titled “Navigation”| Key | Action |
|---|---|
| j / k | Move between cards (↓ and ↑ work too) |
| ] / [ | Jump to the next or previous unresolved thread |
| Enter | Jump to the thread in the diff (inline threads only) |
Enter on an inline thread switches to the Diff tab and moves to the line the comment is on.
Filtering
Section titled “Filtering”Press f to cycle the filter:
| Filter | Shows |
|---|---|
| All | Every thread |
| Unresolved | Only unresolved threads |
| Resolved | Only resolved threads |
Replying
Section titled “Replying”Press r on a card to open the comment editor and reply to that thread. Press CtrlS to post the reply. tongs confirms it with a notification, and the thread shows the reply the next time the tab loads.
Resolving threads
Section titled “Resolving threads”Press ShiftR on a card to resolve the thread, or to reopen a resolved one. tongs asks you to press ShiftR a second time to confirm. Resolving works on both GitHub and GitLab, for threads the forge allows you to resolve.
General comments
Section titled “General comments”To comment on the review as a whole rather than a line, press c on the Overview tab (1).
A review pass through the threads
Section titled “A review pass through the threads”- Open the Discussion tab and press f to show unresolved threads.
- Press Enter on a thread to jump to its line in the diff.
- Read the code around it.
- Press r to reply, or ShiftR twice to resolve.
- Press 4 to return to the Discussion tab and move to the next thread.