git is a brilliant version control system but to say it is self-explanatory is a bit of a stretch 😅 (until now). As this classic xkcd comic shows, many users just memorize a few commands and panic when things go wrong:

This tutorial takes a different approach: You will learn git by actively using it. Executing one command you learn reveals the information about the next command and so on. And most importantly: hopefully, you'll have fun along the way 😉

Run these commands in your terminal:

git clone https://github.com/miallo/nuggit.git # Yay! You already learned about your first git command!
cd nuggit
./build.sh
cd tutorial
ls
# Look! Another README!

and the fun can begin! The whole "game" will now take place in this folder alone. Let's start by reading the README.md inside of that folder 😊

NOTE: If you just want to learn, you don't need to continue reading 😉

Q: Why can't you get the "tutorial" folder with git clone <url> but have to build it?

A: That is a good question and you will figure out the answer the more you get into the quests (many of which are impossible in a fresh clone)…

Alternatively: If you don't want to run this "build"-script yourself (it basically just executes a bunch of git commands to create the folder "tutorial" and fills it with all the information you need), you can download it from the release page: https://github.com/miallo/nuggit/releases

cd ~/Downloads
unzip tutorial.zip
tar --extract --file=tutorial.tar
cd tutorial
ls
# Look! Another README!

and then you are ready! The whole "game" will now take place in this folder only. Let's start by reading the README.md in that folder 😊

Note: for some cursed reason thanks to GitHub, the folder must also be inside of a tarball to remain playable…

• diff (--staged/@{u})
• add
• commit (-m)
• show
• switch (-c)
• push
• pull
• log
• rebase
• merge
• cherry-pick (range/--abort)
• reset (--hard/--soft)
• restore (--staged/--source/--ours)
• revert

If you want to work on this challenge and improve it, architecture contains a short introduction on how this project is structured.