タグ

2014年8月22日のブックマーク (2件)

  • オレオレコミットメッセージの生煮え書き方 - Qiita

    はじめに 自分がコミットメッセージを書くときに考えていることを書きます。 ただし、絶対にこの書き方をずっと続けるというわけでありません。日が経つにつれ、「そういえばこんなことも思ってた」「こういうのいいなあ」「これないわー」といった心境の変化があると予想するので、その時その時で手を入れていくつもりでいます(入れないかもしれません)。なので生煮えです。たぶんずっと生煮えです。それにかこつけて文章の文体もざっくりしています。 あと、あくまでもオレオレなので他の人の書き方をどうこうする意図はありません。うっかり参考になったらいいなあぐらいです。 最初に概念的な話をしてから後半で実際の書き方に入ります。 なお、全体的に git を使う想定で書いていますが、それ以外でも大体同じだと思います。 コミットメッセージには何を書くのか そのコミットでリポジトリに入れた差分が何をしているのか、なぜそうしている

    オレオレコミットメッセージの生煮え書き方 - Qiita
  • コミットメッセージの書き方 - 2012-02-21 - ククログ

    はじめに 「分かりやすいコードを書く」、「コードと一緒にテストも書く」等はソフトウェア開発において大切なことです。しかしそれと同じくらい大切なことして「分かりやすいコミットメッセージを書く」があります。これはあまり着目されていなく、見過ごされていることです。 今回は、コミットメッセージの分かりやすさの大切さ、そして、分かりやすくするための書き方を説明します。 コミットメッセージとその大切さ バージョン管理システムとコミット 現在、ほとんど全てのソフトウェア開発ではSubversionやGitなどのバージョン管理システムを使っています。バージョン管理システムを使うことによるメリットというのは、ソフトウェアの変更が記録されていくことにあります。 具体的なメリットは3つあります。 ソフトウェアの調査がしやすくなることです。現時点でのコードと、そして変更の履歴とを組み合わせることで、それらから非常

    コミットメッセージの書き方 - 2012-02-21 - ククログ