クリアなコードの作り方: 意図が伝わるコミットのしかた - 2012-03-13 - ククログ

コミットメッセージの書き方ではコミットをわかりやすくするためには以下の2つの条件を満たす必要があると書きました。 コミットの内容が分かりやすく説明されていること コミットの内容が小さくまとまっていること このうち「コミットの内容が分かりやすく説明されていること」についてはすでに説明済みです。今回は「コミットの内容が小さくまとまっていること」について説明します。 めざすところ 単純にコミットの内容を小さくするだけではわかりやすくなりません。それでは、どのような基準で小さくすればよいのでしょうか。 よく言われることは1つのコミットには1つの小さな論理的にまとまった変更だけにする、というものです。たしかにこれは重要です。しかし、これだけを基準とすると、人によっては大きめなコミットになってしまいます。人それぞれで論理的なまとまりの大きさが異なるからです。 1つのコミットでどうすればよいかを考えるの

[k-holy]

どうしても、リファクタリングしながらインデント直しながら空行タブ削除しちゃうんだよォォ

[tuto0621]

svn環境だと一度のコミットが全員に渡ってしまうのであんまり細かくすると嫌がられる。git環境だとこの位の粒度がいいと思う。まとめて修正してからコミット時に分割してコミットしたりもする。

[mapserver2007]

正直チケットと関連付いていればコメントは割りと適当でいいと思う。ここまで神経質だとハゲる。

[tengo1985]

Git前提。gitのコマンドイメージが浮かばないと面倒すぎると感じそう。でもさすがにtypoぐらいは一気になおすかなぁ。特にメッセージ系のtypo。「1コミット＝1テーマ」だね。

[crist18]

“クリアなコードの作り方: 意図が伝わるコミットのしかた”

[sora_h]

これを読むといいです

[kyohei_hamada]

極端に細かい気もするけど，概ね普段考えていることと同じだ．

[valinst]

ちょいとやりすぎなんじゃないと思うけど、こんなもんなのかな。

[katzchang]

これいいね。

[sonota88]

インデントのみの修正を分けるのは自分もやってた

[sgtakeru]

"「コミットの流れを見ているだけでペアプロしている気分になる」コミットが小さくまとまってる"

[hidehish]

見てる:

[hiro_y]

1つのコミットに1つの意図をこめると伝わりやすいよね

[hokorobi]

「モジュールの中に移動する」のコミットの分け方は全然考えたことなかった。

[gin0606]

"クリアなコードの作り方: 意図が伝わるコミットのしかた - ククログ(2012-03-13)"

[helldeath]

なるほど、モヤモヤしていたものがすっきりします

[hirose504]

モジュールへの移動はファイル間の移動も伴う事が多いけどどうするべきかな

[ledsun]

社内リポジトリのコミット数が1000/人年のアカウントがこちらになります。・・・それでもここまで細かく分けないぞ。

[mat_aki]

クリアなコードの作り方: 意図が伝わるコミットのしかた - ククログ(2012-03-13) -

[kshimo69]

うーん。

[kinushu]

コミットのタイミング、最近気にしてます

[masu_mi]

ローカルでコミット編集してからpushするのよね。なので細かくできる。svnでも意味単位を切らない様にしろってのは同じなのだろうけど。しかし間違いに気付きやすくするって視点は抜けてた。。

[koogawa]

ここまで意識してなかったなー(；´ω｀) 賛同できるところだけ参考にさせて頂きます

[m_insolence]

細かすぎて全体像が掴めないのでは。

[amino_acid9]

「コミットの内容が小さくまとまっていること」それにしても細かい…

[ghostbass]

ちょい細かすぎないかなあ

[rin51]

けっこう細かいのだな

[sivadselim]

クリアなコードの作り方: 意図が伝わるコミットのしかた - ククログ(2012-03-13)

[stealthinu]

すごく細かく修正内容毎にコミットすべきという指針。少人数で開発されるソフトよりもいろんな人たちが関わるフリーウェアでは大事になるのだろう。最近クリアコードさんのエントリ、ホッテントリ多いな。

[masato-ka]

コミットする単位の方針的な。Subversionとかでやっちゃうと大変だと思うけど、DVCSとかでやって必要なければ後で履歴圧縮しちゃえばいいかな。差分を見たときの見易さを目安にコミットしたいところ。

[koseki]

ログが読めなくなりそうだけど、、コミットログの冒頭に記号いれたりとかするといいかなー。gitとか気軽にブランチ切れると平気なのか。