Skip to content

[CTX-1577] fix(docs): correct quickstart macOS paths and alt+n split plan claim - #172

Merged
Xuepoo merged 1 commit into
mainfrom
ctx-1577/fix-quickstart-claims
Oct 25, 2026
Merged

Xuepoo merged 1 commit into
mainfrom
ctx-1577/fix-quickstart-claims

Conversation

@Xuepoo

@Xuepoo Xuepoo commented Oct 25, 2026

Copy link
Copy Markdown
Contributor

Task

CarryCtx CTX-1577 — docs fix lane ctx1577-docs in bitty-website.

What changed (09e009d)

  • quickstart.md (en + zh-CN): correct the macOS claims. The resolver implements no macOS branch — macOS resolves through the same Unix XDG roots as Linux/BSD: config via XDG_CONFIG_HOME or ~/.config (Linux/BSD and macOS rows merged), and cleanup rows now name state XDG_STATE_HOME / ~/.local/state and data XDG_DATA_HOME / ~/.local/share instead of fabricated ~/Library paths.
  • actions-catalog.md (en + zh-CN): rewrite the alt+n / new_panel behavior row. The shipped default is Spiral (4-way clockwise rotation around the focused pane, focus following the fresh pane) with a largest-feasible Balanced fallback when the focused slot cannot host two panes — not the "adaptive dwindle axis" wording (Dwindle is an explicit opt-in, as are Balanced and BisectLargest).

Note: the alt+n claim was not present in quickstart.md on main; its only shipped wording is the new_panel row of the actions catalog, so the demanded corrected wording landed there (surgical: one row per file, table alignment preserved).

Grounding

Verified against bitty runtime source: bitty-config/src/file.rs resolver (XDG precedence, no OS branch), bitty-runtime/src/config.rs PanelLayoutMode (default Spiral, issue #2571), layout_focus.rs panel split plan (largest-area Balanced fallback).

Verification

  • bun run check green from the worktree (exit 0): format, markdownlint, 371 tests / 22 files, docs:check, typecheck, build, validate:dist, a11y audit, wrangler dry-run.
  • CarryCtx: agent ctx1577-docs registered; task CTX-1577 started; progress note PX-8212 recorded (task not closed).
  • No release-version references touched.

@Xuepoo Xuepoo left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Independent review (Blitz guard, agent ≠ ctx-1577 implementer) @ 09e009d — verified:

  1. quickstart.md (en + zh-CN): fabricated macOS ~/Library/Application Support / ~/Library/Logs|Caches rows removed; config row unified to $XDG_CONFIG_HOME/~/.config; cleanup section now names state (XDG_STATE_HOME/~/.local/state) and data (XDG_DATA_HOME/~/.local/share) XDG roots. Matches bitty-config/src/file.rs resolver (no macOS branch). ✔
  2. actions-catalog.md (en + zh-CN): alt+n/new_panel row corrected to shipped default Spiral (clockwise rotation, focus follows fresh pane) with largest-feasible Balanced fallback; Balanced/Dwindle/BisectLargest marked opt-in. Matches bitty-runtime/src/config.rs PanelLayoutMode default. ✔
  3. Locale files kept in sync; no release-version references touched. ✔
  4. bun run check exit 0 locally; CI Website quality / CodeQL / Analyze green on the exact head SHA. ✔

Verdict: approve-equivalent; merging per docs-delivery flow.

@Xuepoo
Xuepoo merged commit 5cefafe into main Oct 25, 2026
4 checks passed
@Xuepoo
Xuepoo deleted the ctx-1577/fix-quickstart-claims branch October 25, 2026 23:01
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.

1 participant