Skip to content

Commit 2816a3b

Browse files
brabojclaude
andcommitted
feat: rewrite home page with motivation and personal story (#139)
Add "Why This Tutorial" section — concepts before commands, structured path, practical playbook, AI workflow foundation. Add personal origin story in About section. Remove Quick start (duplicated Introduction links). Rename "Selected references" to "Further Reading". Fix heading case to title case for consistency with chapters. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 9668f5d commit 2816a3b

1 file changed

Lines changed: 53 additions & 18 deletions

File tree

astro-site/src/pages/index.astro

Lines changed: 53 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ import DocLayout from "../layouts/DocLayout.astro";
44
const base = import.meta.env.BASE_URL;
55
66
const headings = [
7-
{ depth: 2, slug: "what-youll-learn", text: "What you'll learn" },
7+
{ depth: 2, slug: "why-this-tutorial", text: "Why This Tutorial" },
8+
{ depth: 2, slug: "what-youll-learn", text: "What You'll Learn" },
89
{ depth: 2, slug: "chapters", text: "Chapters" },
9-
{ depth: 2, slug: "quick-start", text: "Quick start" },
1010
{ depth: 2, slug: "about", text: "About" },
11-
{ depth: 2, slug: "selected-references", text: "Selected references" },
11+
{ depth: 2, slug: "further-reading", text: "Further Reading" },
1212
];
1313
1414
const jsonLd = {
@@ -37,12 +37,45 @@ const jsonLd = {
3737
>
3838

3939
<p>
40-
A hands-on tutorial that takes you from first commit to confident daily use.
41-
Learn Git's concepts first, then apply them through practical exercises
42-
and real-world examples.
40+
Git is everywhere — in every team, every deployment pipeline, and every
41+
AI coding tool. Yet most developers learn it by memorizing commands
42+
without understanding what happens underneath.
4343
</p>
4444

45-
<h2 id="what-youll-learn">What you'll learn</h2>
45+
<p>
46+
This tutorial takes a different approach. You learn the concepts first —
47+
how Git stores data, how branches actually work, what a merge really
48+
does — then apply that understanding through exercises and a 17-recipe
49+
playbook you can reach for every day.
50+
</p>
51+
52+
<h2 id="why-this-tutorial">Why This Tutorial</h2>
53+
54+
<ul>
55+
<li>
56+
<strong>Concepts before commands</strong> — understand the object model,
57+
references, and the index so that every command makes sense instead of
58+
feeling like magic.
59+
</li>
60+
<li>
61+
<strong>Structured learning path</strong> — not a cheat sheet, not a
62+
wall of text. Nine chapters that build on each other, with exercises
63+
and quizzes to check your understanding.
64+
</li>
65+
<li>
66+
<strong>Practical playbook</strong> — 17 recipe pages covering
67+
everyday tasks, branching, remotes, debugging, and more. Look up
68+
what you need, copy the commands, understand why they work.
69+
</li>
70+
<li>
71+
<strong>Foundation for AI workflows</strong> — tools like Claude Code,
72+
Cursor, and Copilot use Git under the hood. AI works best when you
73+
know what you're asking for — understanding Git internals helps you
74+
work with these tools effectively and catch mistakes.
75+
</li>
76+
</ul>
77+
78+
<h2 id="what-youll-learn">What You'll Learn</h2>
4679

4780
<ul>
4881
<li>
@@ -116,24 +149,26 @@ const jsonLd = {
116149
</tbody>
117150
</table>
118151

119-
<h2 id="quick-start">Quick start</h2>
120-
121-
<p>New to Git? Start here:</p>
152+
<h2 id="about">About</h2>
122153

123-
<ol>
124-
<li><a href={`${base}introduction/#installation`}>Install Git</a> on your machine</li>
125-
<li><a href={`${base}introduction/#how-git-works`}>Understand how Git works</a> — workspace, index, repository</li>
126-
<li><a href={`${base}introduction/#exercises`}>Try the exercises</a> — clone, commit, push, pull</li>
127-
</ol>
154+
<p>
155+
This tutorial started as personal memo pages — quick notes I wrote for
156+
myself because I kept forgetting how Git works. Over time, those notes grew into Markdown documents, then chapters
157+
with diagrams and exercises, then an Astro site with quizzes, a
158+
17-recipe playbook, and the structured tutorial you see now.
159+
More than 200 hours of writing, rewriting, and refining.
160+
</p>
128161

129-
<h2 id="about">About</h2>
162+
<p>
163+
If it helps you understand Git a little better, it was worth every hour.
164+
</p>
130165

131166
<ul>
132167
<li>Created by <a href="https://github.com/braboj">Branimir Georgiev</a> and <a href="https://github.com/marwan-rashed">Marwan Rashed</a></li>
133-
<li>Part of <a href="https://codewithbranko.com">Code with Branko</a> — practical tutorials for developers</li>
168+
<li>Part of <a href="https://codewithbranko.com">Code with Branko</a> — practical tutorials for developers by heart</li>
134169
</ul>
135170

136-
<h2 id="selected-references">Selected references</h2>
171+
<h2 id="further-reading">Further Reading</h2>
137172

138173
<ul>
139174
<li><a href="https://git-scm.com/book/en/v2">Pro Git Book</a> — the definitive reference</li>

0 commit comments

Comments
 (0)