タグ

2014年5月30日のブックマーク (2件)

  • Blog

    Transformational Software Engineering Lead your team into the future with unprecedented visibility. Details

    Blog
    iori_o
    iori_o 2014/05/30
    "開発チームの規模はコードの品質に影響を与えるのか?"
  • 提言: コミットメッセージの一行目には要求仕様を書け - Qiita

    これは Git (や Subversion などのバージョン管理システム) にコミットする時により良いコミットメッセージを書くための提言です。この提言は特にメッセージの一行目だけを対象とします。せめて最も重要な一行目だけでも良いメッセージを書いて欲しいからです。提言をズバリ一言で表すと 一行目には要求仕様を書け です。 背景 プロジェクトによっていろいろ慣習の差はあるものの、一般的には「コミットメッセージの一行目は変更内容の要約を簡潔に書け」とされます。特に Git は、各コミットメッセージの一行目だけを取り出してそれを一覧表示するなど、一行目を特別に処理する機能が多いので、一行目にできるだけ多くの情報を凝縮させることは重要です。またメッセージを一行しか書かない不届きな慣習のプロジェクトでは、十分な情報を持たないメッセージは無用の長物と化します。 良くないコミットメッセージ しかし私は、情

    提言: コミットメッセージの一行目には要求仕様を書け - Qiita
    iori_o
    iori_o 2014/05/30
    主語はプログラムではなく「このコミット」にしている。要求仕様はそれをひとまとめにした pull request に書くようにしている。要求仕様を満たす為にどんなコミットを積んだかわかるようにしておきたい。