Make a commit

A commit is a snapshot of every single file in your project folder, along with some metadata such as when the commit was made, who made it, and a short message describing the reasoning behind the work. A repository is just a pile of commits - you can compare the files in one commit to another, search through the commits to see when a certain change was made, whatever!

Each row in the History table (the bottom of the screen) represents a commit. If you just created an empty repository, then you won't have much to look at yet, but you will soon! If you click a commit, you can see the names of files that were created, deleted, or changed between that commit and the previous commit.

Click a commit

If you click one of the changed files, you can see the actual contents of the file and how it changed.

Created, deleted, and changed files

You can also see metadata about who made the commit, when, and why.

Who, what, when, why

If you double-click a commit, it will open the snapshot as a folder, so that you can see exactly what the project folder looked like when the snapshot was taken.

Open as a folder

Now you're going to make your own commit. In the list of commits at the bottom, there is always a special row for something called the "working copy", often abbreviated "WC". The working copy is a draft of the next commit you're going to make. If you're looking at the working copy, then this button will say Commit. If it doesn't say Commit, then it will say Go to WC, and if you click it, it will take you to the working copy.

Go to the WC

Once you're at the working copy, the Changed files section will show you which files you have modified in your project directory. To make sure that it is up-to-date, you can hit the refresh button.

You can change your files however you'd like, but here's how the video below does it:

  • double-click the project folder (which opens the folder)
  • double-click a file (which opens that file)
  • make some edits, then hit Ctrl + S to save.

Refresh changed files

To make a commit, you need to check the box for which files you'd like to commit, and type in a commit message which explains the reasoning behind your changes. Once you have done those two things, hit the "Commit" button and you'll make your very first commit!

Make the commit

Set your username

Every time you make a commit, it will be tagged with your name and email. That way when you share your commits, your colleagues will be able to know who to contact if they'd like to discuss a particular change. You only have to set your username once, and it will be set for all the commits you make to every repository.

From the top menu bar, go to Help -> Preferences, then DiffPlug -> Filesystems -> Git. Hit the Edit button to the right of committer and type in your name and email. Now it will be attached to all the commits you make from now on.

Refresh changed files