Commits
Each commit records one saved change to a branch: who made it, when, and a commit message. The Commits page lists a branch's commits and lets you open, compare, and restore them.
Open the Commits page
The Commits page always shows one branch: the branch you have selected. Open it from any of these places:
- Overview tab of the System: in the Version control card, click Total commits in <branch>.
- Activity tab of the System: select the Commits filter, then click Branch Commits (N).
- Branches tab: open a branch's options menu and select View Commits. See Branches.
To jump straight to the latest commit instead, click the Commit hash in the Version control card on Overview.
To see another branch's commits, use the branch picker under the Commits title. The back arrow returns to the System's home page.
Read the commit list
Commits are grouped by day under Commits on <date>, newest first. Each row shows:
- The first line of the commit message (click it to open the commit)
- The author and how long ago the commit was made
- Latest on the branch's current commit
- The short commit hash
Row buttons:
- Restore: add a new commit with this commit's contents. Not shown on the Latest commit. See Restore a commit.
- Copy ID: copy the full commit ID.
- Create change request: open a new change request. See Change requests.
When newer Resource or Subsystem versions are waiting to be accepted, a New changes available card appears above the list. See Accept changes.
Open a commit
Click a commit's message to open Commit #<hash>. The page shows:
- Authored by: the author and the commit date
- Commit Message: the full message
- Version Control: counts of Changed, Added, and Removed items compared with the previous commit on the branch
- The directory as it was at that commit, with changed items marked
Select a changed Resource to compare it side by side with its version in the previous commit. Use Split view or Unified view to change the layout. Use Show directory or Hide directory to toggle the tree. Click the back arrow to return to the commit list.
The first commit on a branch has no previous commit, so it has nothing to compare against.
Restore a commit
Restore adds a new commit with the contents of an earlier commit. Nothing in the branch's history is lost.
The legacy Systems page calls this action Rollback to this commit.
- On the Commits page, click Restore on a commit row, or open the commit and click Restore in the Version Control card.
- In Are you sure you want to Restore?, click Yes, I am.
After the restore:
- A new commit appears at the top of the list as Latest, with the restored contents.
- The commit you restored stays where it was in the list.
- Every commit in between stays listed. The previous Latest commit can now be restored too.
If someone else changed the branch after you opened the page, the restore is canceled. Review the latest commits and try again.
Required role: Editor or above. Archived branches must be restored first.
Still in the legacy Systems page
These commit actions aren't in the redesigned Systems experience yet. Use the legacy Systems page (/systems) for them. See Systems.
- Compare any two commits. In the legacy page, use Compare versions in Commit history. The redesign only compares each commit with the one before it.
- Create a branch from an earlier commit. In the legacy page, use Create branch from this commit in Commit history.