braboj · braboj · Apr 25, 2026 · Apr 25, 2026
diff --git a/astro-site/astro.config.mjs b/astro-site/astro.config.mjs
@@ -1,12 +1,14 @@
 // @ts-check
 import { defineConfig } from 'astro/config';
+import sitemap from '@astrojs/sitemap';
 import { remarkRewriteLinks } from './src/plugins/remark-rewrite-links.ts';
 
 // https://astro.build/config
 export default defineConfig({
   site: 'https://braboj.github.io',
   base: '/tutorial-git/',
   trailingSlash: 'always',
+  integrations: [sitemap()],
   markdown: {
     syntaxHighlight: false,
     remarkPlugins: [remarkRewriteLinks],

diff --git a/astro-site/package-lock.json b/astro-site/package-lock.json
diff --git a/astro-site/package.json b/astro-site/package.json
@@ -12,6 +12,7 @@
     "astro": "astro"
   },
   "dependencies": {
+    "@astrojs/sitemap": "^3.7.2",
     "astro": "^6.1.8"
   }
-}
+}
diff --git a/astro-site/public/robots.txt b/astro-site/public/robots.txt
@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://braboj.github.io/tutorial-git/sitemap-index.xml
diff --git a/astro-site/src/content.config.ts b/astro-site/src/content.config.ts
@@ -9,6 +9,7 @@ const docs = defineCollection({
   }),
   schema: z.object({
     title: z.string(),
+    description: z.string().optional(),
     section: z.string(),
     order: z.number(),
   }),

diff --git a/astro-site/src/layouts/DocLayout.astro b/astro-site/src/layouts/DocLayout.astro
@@ -8,26 +8,52 @@ import site from "../data/site.json";
 
 interface Props {
   title: string;
+  description?: string;
   headings?: { depth: number; slug: string; text: string }[];
   currentPath?: string;
+  jsonLd?: Record<string, unknown>;
 }
 
-const { title, headings = [], currentPath = "/" } = Astro.props;
+const { title, description, headings = [], currentPath = "/", jsonLd } = Astro.props;
+const pageDescription = description || site.description;
+const pageTitle = `${title} — ${site.title}`;
+const canonicalUrl = new URL(Astro.url.pathname, Astro.site);
+const ogImage = new URL("/tutorial-git/images/og-banner.png", Astro.site);
 ---
 
 <!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>{title} — {site.title}</title>
-    <meta name="description" content={site.description} />
+    <title>{pageTitle}</title>
+    <meta name="description" content={pageDescription} />
+    <link rel="canonical" href={canonicalUrl} />
+
+    <!-- Open Graph -->
+    <meta property="og:type" content="article" />
+    <meta property="og:title" content={pageTitle} />
+    <meta property="og:description" content={pageDescription} />
+    <meta property="og:url" content={canonicalUrl} />
+    <meta property="og:image" content={ogImage} />
+    <meta property="og:site_name" content={site.title} />
+
+    <!-- Twitter Card -->
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:title" content={pageTitle} />
+    <meta name="twitter:description" content={pageDescription} />
+    <meta name="twitter:image" content={ogImage} />
+
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link
       href="https://fonts.googleapis.com/css2?family=Roboto:wght@300;400;500;600;700&family=Roboto+Mono:wght@400;500&display=swap"
       rel="stylesheet"
     />
+
+    {jsonLd && (
+      <script type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+    )}
   </head>
   <body>
     <a href="#main-content" class="skip-link">Skip to main content</a>

diff --git a/astro-site/src/pages/[...slug].astro b/astro-site/src/pages/[...slug].astro
@@ -19,8 +19,35 @@ export async function getStaticPaths() {
 const { page, entry } = Astro.props;
 const { Content, headings } = await render(entry);
 const sectionPath = `/${page.section}/`;
+
+const jsonLd = {
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": page.title,
+  "description": entry.data.description || "",
+  "author": {
+    "@type": "Person",
+    "name": "Branimir Georgiev",
+    "url": "https://github.com/braboj"
+  },
+  "publisher": {
+    "@type": "Person",
+    "name": "Branimir Georgiev"
+  },
+  "isPartOf": {
+    "@type": "Course",
+    "name": "Git Tutorial — Code with Branko",
+    "url": "https://braboj.github.io/tutorial-git/"
+  }
+};
 ---
 
-<DocLayout title={page.title} headings={headings} currentPath={sectionPath}>
+<DocLayout
+  title={page.title}
+  description={entry.data.description}
+  headings={headings}
+  currentPath={sectionPath}
+  jsonLd={jsonLd}
+>
   <Content />
 </DocLayout>
diff --git a/astro-site/src/pages/index.astro b/astro-site/src/pages/index.astro
@@ -10,9 +10,31 @@ const headings = [
   { depth: 2, slug: "about", text: "About" },
   { depth: 2, slug: "selected-references", text: "Selected references" },
 ];
+
+const jsonLd = {
+  "@context": "https://schema.org",
+  "@type": "Course",
+  "name": "Git Tutorial — Code with Branko",
+  "description": "A hands-on Git tutorial from first commit to confident daily use — concepts, exercises, and real-world examples.",
+  "url": "https://braboj.github.io/tutorial-git/",
+  "provider": {
+    "@type": "Person",
+    "name": "Branimir Georgiev",
+    "url": "https://github.com/braboj"
+  },
+  "educationalLevel": "Beginner to Advanced",
+  "inLanguage": "en",
+  "isAccessibleForFree": true
+};
 ---
 
-<DocLayout title="Let's Learn Git!" headings={headings} currentPath="/">
+<DocLayout
+  title="Let's Learn Git!"
+  description="A hands-on Git tutorial from first commit to confident daily use — concepts, exercises, and real-world examples."
+  headings={headings}
+  currentPath="/"
+  jsonLd={jsonLd}
+>
 
   <p>
     A hands-on tutorial that takes you from first commit to confident daily use.

diff --git a/chapters/01-introduction.md b/chapters/01-introduction.md
@@ -1,5 +1,6 @@
 ---
 title: "Introduction"
+description: "What Git is, how to install it, how it works internally, and an overview of the most common commands."
 section: "introduction"
 order: 1
 ---

diff --git a/chapters/02-building-blocks.md b/chapters/02-building-blocks.md
@@ -1,5 +1,6 @@
 ---
 title: "Building Blocks"
+description: "Git internals — repositories, the object model (blobs, trees, commits, tags), the staging area, references, and HEAD."
 section: "building-blocks"
 order: 2
 ---

diff --git a/chapters/03-branching-and-merging.md b/chapters/03-branching-and-merging.md
@@ -1,5 +1,6 @@
 ---
 title: "Branching and Merging"
+description: "Create branches, merge and rebase changes, cherry-pick commits, resolve conflicts, and use the stash."
 section: "branching-and-merging"
 order: 3
 ---

diff --git a/chapters/04-remote-repositories.md b/chapters/04-remote-repositories.md
@@ -1,5 +1,6 @@
 ---
 title: "Remote Repositories"
+description: "Work with remote repositories — clone, fetch, pull, push, remote tracking branches, and forking workflows."
 section: "remote-repositories"
 order: 4
 ---

diff --git a/chapters/05-nested-repositories.md b/chapters/05-nested-repositories.md
@@ -1,5 +1,6 @@
 ---
 title: "Nested Repositories"
+description: "Include external repositories in your project using Git submodules and subtrees — trade-offs, workflows, and commands."
 section: "nested-repositories"
 order: 5
 ---

diff --git a/chapters/06-expert-topics.md b/chapters/06-expert-topics.md
@@ -1,5 +1,6 @@
 ---
 title: "Expert Topics"
+description: "Power-user Git — configuration layers, revision selectors, pathspec, refspec, interactive rebase, bisect, hooks, and garbage collection."
 section: "expert-topics"
 order: 6
 ---

diff --git a/chapters/07-playbook.md b/chapters/07-playbook.md
@@ -1,5 +1,6 @@
 ---
 title: "Playbook"
+description: "Step-by-step recipes for common Git tasks — undoing changes, branching, merging, rebasing, stashing, tagging, and debugging."
 section: "playbook"
 order: 7
 ---

diff --git a/chapters/08-appendix.md b/chapters/08-appendix.md
@@ -1,5 +1,6 @@
 ---
 title: "Appendix"
+description: "Reference material — merge strategies, SSH key setup, Git clients, and external resources."
 section: "appendix"
 order: 8
 ---

diff --git a/chapters/09-glossary.md b/chapters/09-glossary.md
@@ -1,5 +1,6 @@
 ---
 title: "Glossary"
+description: "Key Git terms and definitions — blob, branch, commit, HEAD, merge, rebase, remote, stash, tag, and more."
 section: "glossary"
 order: 9
 ---