Skip to content

docs: document branch-per-OS structure and fix clone path - #3

Draft
LJLee37 wants to merge 1 commit into
macOSfrom
claude/settingfiles-restructure-raspi-arch-uk2buw-macos
Draft

docs: document branch-per-OS structure and fix clone path#3
LJLee37 wants to merge 1 commit into
macOSfrom
claude/settingfiles-restructure-raspi-arch-uk2buw-macos

Conversation

@LJLee37

@LJLee37 LJLee37 commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Summary

Part of a repo-wide cleanup (companion PRs on master, arch, ubuntu, alpine, raspi, plus a new raspi-arch branch for Arch Linux ARM — see the master PR for the full rationale on why .vimrc/.zshrc aren't being physically merged across branches).

  • Adds the branch table / repo-structure explanation to README.
  • Fixes the clone command to git clone -b <branch> ... ~/gitRepos/settingfiles (this branch's set.sh already used the correct path — no script change needed here).
  • Adds a one-line macOS note about set.sh installing GUI apps via Homebrew and copying karabiner.json into place.

No other content changes.

Note: pre-audit correction

The task's pre-audit described macOS's .zshrc as differing from the shared version only by "code block order." That's not accurate — macOS/.zshrc has real functional differences from master/arch/ubuntu (extra zsh-vi-mode plugin, different PATH entries for llvm/openjdk instead of yarn/nvm caches, no keychain/GPG_TTY/systemctl suspend lines, updated oh-my-zsh comment text). Per the task's own decision rule, only the truly identical portions are being treated as "shared" — these real differences are left as-is on this branch, not merged or removed.

Hardcoded personal values

None specific to this branch beyond what's already listed in the master PR (git identity, keychain identity ljlee_id, etc. appear in the shared .zshrc content this branch also carries).

Test plan

  • README renders correctly and the clone command works as documented
  • No other files changed on this branch (docs-only)

Generated by Claude Code

README was byte-identical across all 6 branches with no explanation of
the layout. Document the branch table, note master as the canonical
source for shared dotfiles, and switch the clone command to the
correct ~/gitRepos/settingfiles path with a -b <branch> flag.
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.

2 participants