From 0730d77907d9be53d6a5c36f72b93bdca1e84906 Mon Sep 17 00:00:00 2001 From: 2890-claw <2890-claw@hawkcollective2890.com> Date: Fri, 29 May 2026 01:57:28 +0000 Subject: [PATCH] Add Oh My Git! reference page --- AUDIT_MANIFEST.json | 10 ++++++ training/references/oh-my-git.md | 54 ++++++++++++++++++++++++++++++++ 2 files changed, 64 insertions(+) create mode 100644 training/references/oh-my-git.md diff --git a/AUDIT_MANIFEST.json b/AUDIT_MANIFEST.json index a64b7ff..a08e0b5 100644 --- a/AUDIT_MANIFEST.json +++ b/AUDIT_MANIFEST.json @@ -583,5 +583,15 @@ "security", "reference" ] + }, + "training/references/oh-my-git.md": { + "silo": "2890", + "growth": "tree", + "tags": [ + "git", + "version-control", + "game", + "interactive" + ] } } \ No newline at end of file diff --git a/training/references/oh-my-git.md b/training/references/oh-my-git.md new file mode 100644 index 0000000..010e1df --- /dev/null +++ b/training/references/oh-my-git.md @@ -0,0 +1,54 @@ +--- +title: "Oh My Git! — Learn Git Through Gameplay" +growth: tree +last_verified: 2026-05-29 +freshness: seasonal +silo: 2890 +prerequisites: [] +related: + - first-technical-resources + - book-of-secret-knowledge +tags: [git, version-control, game, interactive, programming, beginner] +--- + +# Oh My Git! — Learn Git Through Gameplay + +**Source:** (open source, free download) + +An open-source game that teaches Git by letting you *play* with it. Instead of reading man pages or memorizing commands, you watch Git's internal structures update in real time as you make moves. + +## Why This Matters for Team 2890 + +Every student who touches code on this team needs to know Git — we use Gitea for version control, and bad Git habits (force-pushing to main, confused merges, lost commits) cause real problems. But Git is famously unintuitive when you're learning it from a terminal. + +Oh My Git! solves this by making the abstract visible. You can *see* what a branch is, what a merge does, and what happens when things go wrong. + +## Features + +- **Real-time visualization** — Watch commits, branches, and remotes update as you act. The "ah-ha" moment for understanding branches happens fast when you can see them +- **Playing card interface** — Each Git command is a card with an icon, name, and short description. Learn by doing, not by memorizing +- **Built-in terminal** — Real Git is running under the hood. Advanced or curious players can type any Git command directly +- **Collaboration levels** — Levels that teach remotes, pulling, pushing, and team workflows with multiple repositories + +## Who Should Play This + +- **New programmers** who haven't used Git before (start here before touching Gitea) +- **Anyone confused by branches** — the visualization makes it click +- **Students moving to team repos** — the collaboration levels map directly to our workflow + +## How to Get It + +Download free from the [itch.io page](https://blinry.itch.io/oh-my-git) — available for Linux, macOS, and Windows. + +## After Oh My Git! + +Once you're comfortable with the basics: +- Move on to real Git in the terminal — the commands are the same, just no cards +- Read [[book-of-secret-knowledge|The Book of Secret Knowledge]] for deeper CLI and version control references +- Set up your Gitea account and start contributing to team code + +## Notes + +- The game hasn't been actively updated since 2021, but Git fundamentals haven't changed +- It runs a real Git instance internally — anything you learn transfers directly +- Works offline — no internet needed after download \ No newline at end of file