git is a version control software. It saves the editing history of a
directory: what new files were added, changes to existing files or what
files have been moved. With git, many persons can edit the same collection
of files at the same time and share their work.
At Aalto University, git is used for controlling the version history of the
A+ course materials and publishing changes to the A+ production server https://plus.cs.aalto.fi .
Git is also useful on your own computer: if you delete some file in your
course folder by mistake, or break the code and don’t know how to repair
it, you can revert back to an earlier version of your codebase.
There are many git tutorials for beginners. Try out these:
If you haven’t used git before, do a first-time git setup:
When you edit course material, the most needed git commands are:
Recommendation: “git lol” custom command
One can configure additional commands for git. Copy and paste the following
command to the terminal to add the new command “git lol”. It shows a nice,
semi-graphical tree view of your git history, as in the picture below.
git config --global --add alias.lol "log --graph --decorate --pretty=oneline --abbrev-commit --all"
Aalto University has a service for storing and sharing git repositories
(directories with history in git). In the following, you will be guided
on how to use it.
First, log in to Aalto Gitlab at https://version.aalto.fi .
If you have not used Aalto Gitlab before, you need to add an SSH key.
This is a cryptographic key which enables the data exchange between your
computer and the Aalto Gitlab computer safely. It is required for making
the commands git pull and git push work.
Click on your profile picture circle on the top-right corner of the
page and choose “settings”. Next, on the left sidebar, click on the “SSH option”.
Then, click on the link “generate one” and follow the instructions.
If you know that several persons are editing the same course as you, begin
your working day with git pull. Make many of small commits: edit a
couple of files where the changes are related to each other, like adding
a new chapter, picture or exercise. Do git push many times a day. This
way it is easy to record what files were changed in each editing step.
Essentially, git push backs up your work to Aalto Gitlab
so if your laptop or workstation breaks or is stolen, you will only
lose a work of a few hours.