Skip to content

docs: add session 7 entry to dev journal #149

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
braboj merged 1 commit into from
Apr 25, 2026
+40 −0
Merged

docs: add session 7 entry to dev journal #149

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions docs/dev-journal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -240,3 +240,43 @@ Architecture overview and chronological session log for tutorial-git.

**Open issues:**
- #106, #109, #110, #113, #114, #116–#119, #122, #127, #129, #131–#133, #135, #139, #140

### 2026-04-25 — Playbook split, new recipes, UX improvements, home page

**Tool:** Claude Code (Opus 4.6)

**Key changes:**
- Split monolithic `07-playbook.md` into 11 individual recipe pages under `chapters/playbook/`
- Added 6 new recipe pages: subtrees, hooks, remote management, diffing, history, selectors (17 total)
- Organized playbook index into 5 sections: Everyday, Branching and Merging, Remote, Project Structure, Advanced
- Extended remark link-rewriting plugin to handle subdirectory and sibling file links
- Updated cross-references in glossary and appendix to point to specific recipe pages
- Added draggable sidebar splitters (JS, session-only, teal highlight on hover)
- Widened default sidebar from 12rem to 16rem
- Switched from Google Fonts (Roboto) to system fonts — eliminates font FOUC entirely
- Fixed theme FOUC — moved theme init from body to head
- Added favicon link with correct base path
- Increased tab button spacing to 0.75rem
- Rewrote home page: added "Why This Tutorial" section, personal origin story, AI workflow messaging
- Removed Quick start section (duplicated Introduction links)
- Renamed "Selected references" to "Further Reading"
- Fixed heading case to title case for consistency with chapters

**PRs merged:**
- #142 — Split playbook into individual recipe pages
- #143 — Add 6 new playbook recipe pages
- #144 — Playbook sidebar nav and FOUC fix
- #145 — Resizable sidebars, system fonts, favicon fix
- #148 — Home page rewrite with motivation and personal story

**Issues closed:**
- #129 — Split playbook into individual recipe pages
- #139 — Improve home page with motivation
- #146 — Fix font FOUC (switched to system fonts)

**Issues created:**
- #146 — Fix font FOUC (closed same session)
- #147 — Add AI prompt guides for learning Git

**Open issues:**
- #106, #109, #110, #113, #114, #116–#119, #122, #127, #131–#133, #135, #140, #147
Loading