Skip to content

Rewrite Remote Repositories chapter#120

Merged
braboj merged 9 commits into
mainfrom
fix/remote-chapter-rewrite
Apr 25, 2026
Merged

Rewrite Remote Repositories chapter#120
braboj merged 9 commits into
mainfrom
fix/remote-chapter-rewrite

Conversation

@braboj

@braboj braboj commented Apr 25, 2026

Copy link
Copy Markdown
Owner

Summary

  • Restructure chapter 4 for beginner clarity with concepts-first, commands-last ordering
  • Add Remotes and Tracking section with .git/config, refspec, and branch tracking explanation
  • Add full pull chain walkthrough (how .git/config sections work together)
  • Reorder subsections: remote-tracking branches before managing remotes
  • Add 3 new zoom-in diagrams (fetch, merge, push) showing what changes vs unchanged
  • Redesign flow diagram with remote-tracking inside Local Repo and connected arrows
  • Redesign clone diagram (local-left/remote-right, checkout arrow, .git/config box)
  • Polish all diagrams in draw.io with consistent colors and layout
  • Add new quiz questions testing the mental model
  • Fix cross-chapter anchor links ((TUT-GIT) - Overview #3-merging, (TUT-GIT) - Configuration #6-conflicts)

Closes #111

Test plan

  • npm run build passes (10 pages, 32 images)
  • Cross-chapter links verified
  • Anchor links verified
  • Visual review of all 6 diagrams on live site
  • Read-through for beginner clarity

Generated with Claude Code

braboj and others added 9 commits April 25, 2026 11:59
Restructure chapter 4 for beginner clarity:
- Add Remotes and Tracking section with .git/config and refspec explanation
- Add branch tracking configuration with full pull chain
- Reorder subsections: concepts first, commands last
- Add 3 new zoom-in diagrams (fetch, merge, push) showing what changes
- Redesign flow diagram with remote-tracking inside Local Repo
- Redesign clone diagram with local-left/remote-right layout
- Re-export fork diagram
- Add new quiz questions testing mental model

Closes #111

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Restore palette colors stripped during failed experiment. Update all
diagrams with user edits from draw.io desktop: improved labels,
layout adjustments, and consistent color scheme across flow, clone,
fetch, merge, and push diagrams.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Update #merging and #conflicts anchors to match numbered heading
format (#3-merging, #6-conflicts) in chapter 3.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
After removing astro-site/src/content/docs/ in the single-source
migration, the content directory may not exist in a fresh checkout.
Create it before symlinking assets.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Same fix as deploy.yml — mkdir -p before symlink creation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Lychee v2 requires --base to be a URL or absolute path. Use
github.workspace to construct the absolute path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add --root-dir to resolve root-relative links (/tutorial-git/...) and
--exclude-fragment to skip anchor-only links that lychee cannot verify
in static HTML files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Flag does not exist in lychee v0.23. Keep --root-dir for resolving
root-relative links.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Pre-existing issues with fragment links and Astro base path cause
false failures. Disabled until properly configured.

See #121

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@braboj braboj merged commit 76e039a into main Apr 25, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Review images in Remote Repositories chapter

1 participant