Skip to content

Commit 9ecc13f

Browse files
brabojclaude
andauthored
Rename playbook/ to 07-playbook/ for consistent numbering (#173)
* docs: rename playbook/ to 07-playbook/ for consistent chapter numbering Closes #156 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: extract 07-playbook.md and rename recipe directory to recipes/ Separates the chapter entry point (07-playbook.md) from the recipe pages (recipes/). All chapters now follow the NN-name.md pattern and the recipe directory has a self-explanatory name. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: use playbook/ in markdown links to match URL routing The remark link rewriter maps directory names to URLs. Since recipe pages have section: "playbook/..." in frontmatter, their URLs are /playbook/X/ not /recipes/X/. Markdown links must use playbook/ to produce correct URLs after rewriting. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 7a1cefe commit 9ecc13f

23 files changed

Lines changed: 62 additions & 60 deletions

CLAUDE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ chapters/ # SSG-agnostic tutorial content (canonical)
3737
05-nested-repositories.md
3838
06-expert-topics.md
3939
07-playbook.md
40+
recipes/ (17 recipe pages)
4041
08-appendix.md
4142
09-glossary.md
4243
assets/

chapters/07-playbook.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: "Playbook"
3+
description: "Step-by-step recipes for common Git tasks — undoing changes, branching, merging, rebasing, stashing, tagging, and debugging."
4+
section: "playbook"
5+
order: 7
6+
---
7+
8+
## Overview
9+
10+
This chapter is a quick-reference collection of recipes for common
11+
Git tasks. Each recipe shows the problem, the commands to solve it,
12+
and what to watch out for.
13+
14+
For command syntax, see the [official Git reference](https://git-scm.com/docs).
15+
For definitions, see [Glossary](09-glossary.md).
16+
17+
## Everyday
18+
19+
| Recipe | What you'll find |
20+
|--------|-----------------|
21+
| [Undoing Changes](playbook/undoing-changes.md) | Discard, unstage, reset, revert, and recover lost commits |
22+
| [Diffing](playbook/diffing.md) | Unstaged, staged, between branches, commits, and files |
23+
| [History](playbook/history.md) | Log formatting, filtering by author, date, and path |
24+
| [Stashing](playbook/stashing.md) | Save and restore work in progress |
25+
26+
## Branching and Merging
27+
28+
| Recipe | What you'll find |
29+
|--------|-----------------|
30+
| [Branching](playbook/branching.md) | Create, delete, rename, and inspect branches |
31+
| [Merging](playbook/merging.md) | Fast-forward, no-ff, squash, conflict resolution |
32+
| [Rebasing](playbook/rebasing.md) | Linearize history and squash commits interactively |
33+
| [Cherry-Picking](playbook/cherry-picking.md) | Apply individual commits across branches |
34+
35+
## Remote
36+
37+
| Recipe | What you'll find |
38+
|--------|-----------------|
39+
| [Remote Operations](playbook/remote-operations.md) | Push, pull, force push safely, sync forks |
40+
| [Remote Management](playbook/remote-management.md) | Add, rename, remove remotes, switch URL, SSH setup |
41+
42+
## Project Structure
43+
44+
| Recipe | What you'll find |
45+
|--------|-----------------|
46+
| [Tagging](playbook/tagging.md) | Create, push, and delete annotated tags |
47+
| [Submodules](playbook/submodules.md) | Add, clone, update, and remove submodules |
48+
| [Subtrees](playbook/subtrees.md) | Add, pull, push, and remove subtrees |
49+
50+
## Advanced
51+
52+
| Recipe | What you'll find |
53+
|--------|-----------------|
54+
| [Selectors](playbook/selectors.md) | Tilde, caret, double-dot, triple-dot, reflog refs |
55+
| [Hooks](playbook/hooks.md) | Pre-commit, commit-msg, sharing hooks, bypassing |
56+
| [Debugging](playbook/debugging.md) | Bisect, blame, and search commit history |
57+
| [Configuration](playbook/configuration.md) | Identity, defaults, aliases, and diagnostics |

chapters/08-appendix.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ order: 8
99

1010
This appendix contains reference material that supports the tutorial
1111
chapters — merge strategies, Git clients, external resources, and
12-
notes. For step-by-step recipes, see the [Playbook](playbook/index.md).
12+
notes. For step-by-step recipes, see the [Playbook](07-playbook.md).
1313
For command help, run `git help <command>`.
1414

1515
In this chapter you will learn:

chapters/playbook/index.md

Lines changed: 0 additions & 57 deletions
This file was deleted.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)