Read the timeline

The Timeline is a board of the workspace's pull requests over time. Each repository is a block; inside it, each contributor has a row. Each pull request is a bar from when it opened to when it merged or closed (or now), and the reviews, comments and commits on it are marks along the bar. It shows the last 14 days by default.

#Switch it on

The Timeline is optional and off by default. To use it, open Settings → Features and switch on Timeline. It then shows in the sidebar, with g t, and the Focus and Show on the timeline buttons come back.

While it is off, Limn does not load the board, a link to the Timeline opens Open pull requests, and a pull request opens in its own tab instead of a Focus tab.

#What you see

Bars

• An open pull request's bar is strong; a merged or closed one is faded. A draft is drawn as a draft.
• An open bar's outline shows its review: changes requested, approved, or commented. A blocking review wins.
• An orange bar is stalled: it has open review threads and no commit for more than three days.
• A pull request whose review is requested from you is marked as yours to do.

Marks

Each event is a small mark whose shape says its type: a review (approve in green, changes requested in orange, a comment in grey), a review comment, a pull request comment, a commit, or a change of state such as opened or merged. When you zoom out, marks close together join into one mark with a number.

#What you can do

• Move and zoom. Drag the board sideways; zoom with the trackpad or the mouse wheel. Choose a Range (7d, 14d, 30d, 90d), and Now to centre on the current time.
• Click a bar to open its card: the repository and number, its state, author, whether it can merge, its checks, its review, its size, its age and last activity, and its ticket. Choose Open details to open the pull request in its own tab, or Open on GitHub.
• Click a mark to see that event. Open details opens the pull request at that event: the thread, the comment or the commit.
• Double-click a bar to open the pull request in a Focus tab. See Focus one pull request.
• Click a person's name to see their counts for the last 90 days, a link to their GitHub profile, and Last 14 days of activity →, which opens their activity as a tab. A shield beside a name marks someone who has merged a pull request in that repository.
• Collapse a row with the arrow beside a person's name. Limn remembers it.

From a pull request, Show on the timeline centres the board on it and makes it pulse, so you can see it among the others.

#On a phone

On a phone the Timeline shows as a list, one line per pull request, grouped by repository, newest activity first. Tap a line to open the pull request. Choose Board to see the board.

#Why it helps

Lists show what is waiting now. The timeline shows how the work moved: a pull request that has been open for three weeks stands out as a long bar, and a review that came days after the last commit shows as a gap.