Skip to content

[B] 運用トラブルシュートドキュメントを追加する #38

Description

@devgamesan

背景

実運用では、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が自動解決しない範囲と、開発環境で実行すべき作業が明確になっている

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions