背景
実運用では、dirty working tree、diverged branch、detached HEAD、SSH失敗、origin権限エラー、LFS/submodule非対応などのトラブルが発生する。
現状READMEには基本フローはあるが、障害時の復旧手順をまとまって参照できるドキュメントが不足している。
やりたいこと
docs/troubleshooting.md を追加する
- 代表的なエラー別に原因、確認コマンド、復旧手順を整理する
doctor / status / branch の使い分けを説明する
- LFS/submodule非対応時の注意点を明記する
受け入れ条件
- READMEからtroubleshootingへリンクする
- dirty状態、diverged状態、detached HEAD、SSH接続失敗、origin fetch/push失敗の手順がある
- 実行環境に合わせたLinux/macOS向けコマンド例になっている
- git-ssh-syncが自動解決しない範囲と、開発環境で実行すべき作業が明確になっている
背景
実運用では、dirty working tree、diverged branch、detached HEAD、SSH失敗、origin権限エラー、LFS/submodule非対応などのトラブルが発生する。
現状READMEには基本フローはあるが、障害時の復旧手順をまとまって参照できるドキュメントが不足している。
やりたいこと
docs/troubleshooting.mdを追加するdoctor/status/branchの使い分けを説明する受け入れ条件