docs(site): add the git and browser guides

Merged
GN
2d ago
+1110-0

Summary

Part 3 of six stacked PRs for the Termul user guide. Adds the Git and Browser and canvas sections: git (changes, staging and committing, branches and stash, history, worktrees) and the desktop browser, page annotations, agent browser control and the canvas.

Pages describe what the app does today, checked against the source and the running browser build. Desktop-only features are marked and have no screenshots, because the capture tool drives the browser build.

Related Issue

No issue: the user guide was requested directly by the maintainer. Stacked on part 2.

Type of Change

  • docs: documentation only

What Changed

  • MDX pages and meta.json for each section.
  • One scripts/screenshots/shots/*.ts file per section and the PNGs it produces.

How It Was Tested

  • bun run types:check and bun run build in website-docs/ at this branch
  • biome ci website-docs/scripts
  • Internal link check over the built site (every /docs/... link and #anchor resolves at the top of the stack)
  • Manual verification completed: every screenshot was opened and checked against its page
  • bun run test, cargo checks: not applicable (docs and a dev-only script; no app code changes)

CI & Review Gate

  • All CI checks pass
  • Code review comments from CodeRabbit / Claude have been addressed or resolved
  • No unresolved review findings remain

Checklist

  • My PR title follows the conventional commit format used by this repo
  • I linked the related issue or explained why none exists
  • I updated docs when needed
  • I added or updated tests when needed (not applicable)
  • I verified the change does not introduce unrelated modifications
  • I read AGENTS.md and followed the contributor guidelines
  • A human reviewed the complete diff before submission

Summary by cubic

Adds the Git and Browser sections to the Termul user guide, the third PR in a stacked series. It covers changes, staging and committing, branches and stashes, history, worktrees, browser tabs, page annotations, agent browser control, and the OpenPencil canvas.

  • New MDX pages and meta.json for each section, plus one shots/*.ts screenshot script per section and the PNGs they produce.
  • Desktop-only features are marked with callouts. Screenshots are limited to what the browser build can show, since the capture tool drives the browser build.

Docs-only change, verified with bun run types:check, bun run build, biome ci on the scripts, and an internal link check over the built site.