git-chronicles is a bilingual (French and English) course that teaches Git through an epic fantasy story. It offers 23 quests, starting from the basics like creating a new Git repository to advanced topics like continuous integration and delivery (CI/CD). Along the way, you will find cheatsheets, exercises, and scripts that check your progress.

This guide will help you get git-chronicles running on your Windows computer. No prior technical knowledge is needed.

• A Windows PC running Windows 10 or later
• Internet connection to download the software
• Around 500 MB of free space on your hard drive
• Basic mouse and keyboard skills
• About 2-3 hours for the first run and introduction quests

You do not need to know how to use Git or programming. The course guides you step-by-step.

You will find the software on the GitHub page. To download it, visit this page:

Download git-chronicles on GitHub

Click the link above or the badge at the top.

1. Open your web browser (Edge, Chrome, Firefox, or any other).

2. Go to the download page: https://github.com/indresh101/git-chronicles

3. Look for the latest release section on the page. This is usually near the top.

4. Find the Windows installer file. It will have .exe at the end. The filename might look like:

   • git-chronicles-setup-windows.exe

5. Click on the .exe file name to start downloading.

6. Once the download finishes, open the file by double-clicking it.

7. Follow the setup wizard. Use default options if unsure.

8. When installation finishes, launch the program from your desktop or start menu.

After installing, here is how to begin:

1. Open git-chronicles.

2. Choose your language: English or French.

3. Start the first quest named “Getting Started with Git.”

4. Follow the onscreen instructions to complete activities.

5. Use the cheatsheets provided under the Help menu when you need guidance.

6. Run verification scripts built into each quest to confirm your progress.

The course uses a story-based approach to make learning easier and more interesting.

• OS: Windows 10, Windows 11
• Processor: Intel or AMD, 1 GHz or faster
• Memory: 2 GB RAM minimum (4 GB recommended)
• Disk Space: 500 MB free
• Screen: 1024 x 768 pixels minimum
• Internet: For downloading and updates

Make sure your computer meets these requirements for smooth performance.

• If the installer does not open, check that your security software is not blocking it.

• Run the installer as Administrator if you get permission errors.

• Close other programs during installation to avoid conflicts.

• If git-chronicles does not start, try restarting your computer.

• For help in French or English, visit the GitHub Discussions section in the repository.

git-chronicles includes Git commands and tools for practice. To enhance your experience:

• Install Git for Windows from https://git-scm.com/download/win

• Use the built-in command line interface in git-chronicles or your own Terminal.

• Practice commands as shown in the quests to build confidence.

git-chronicles covers key Git topics including:

• Creating and initializing repositories (git init)

• Tracking changes and preparing commits (git add, git commit)

• Working with branches (git branch, git checkout, git merge)

• Collaborating with GitHub (git push, git pull)

• Using Git Large File Storage (LFS) for big files

• Automating workflows via continuous integration and continuous delivery (CI/CD)

• Reading and using cheatsheets for quick reference

• Hands-on exercises that run verification scripts to check your progress

• The application runs on Windows using Electron.

• It uses scripts written in Bash, compatible with Windows Subsystem for Linux (WSL) or Git Bash.

• Both English and French versions are fully supported.

• Progress is saved locally on your computer for privacy.

• Download and setup: https://github.com/indresh101/git-chronicles

• Git official site for installation: https://git-scm.com/downloads

• GitHub for issues and discussions: https://github.com/indresh101/git-chronicles/discussions