技術・品質・チーム · 入門
バージョンで作業する：ブランチ、マージ、履歴
一行でいうと: 短いブランチと頻繁なマージはほとんどのバージョンの痛みを防ぐ——そして読める履歴はインシデントを調査する日に努力の価値がある。
シンプルなフロー
安定したメインブランチ、各変更の短いブランチ、レビューとテスト後のマージ。二週間生きるブランチは競合と怖いマージを生む——これはほぼ常にタスクが大きすぎるサインだ。
変更メッセージ
何が変わったかを述べる短い最初の行、次になぜ。「なぜ」はコードから回復できないもので、一年後に探すものだ。
タスクまたは議論にリンクする。コンテキストのない変更は将来の謎だ。
衛生管理
ビルドされたファイル、シークレット、大きなファイルをリポジトリに保存するな。バージョンをタグでマークする。そして既に公開された履歴を書き直さない——それは他人の作業を壊す。
さらに深く
一つのマージポリシーを決め——完全な履歴を保持するか一つの変更に押しつぶすか——そして強制する。何かが壊れたときをちょうど見つける必要があるとき、混合した履歴はナビゲートしにくいため、選択自体より一貫性が重要だ。