⚠️ このドキュメントは編集中/準備中のものです⚠️ いつくかのプロジェクトで試験運用しつつ固めているところです
コミットメッセージの先頭に付与する、視認性の向上を図り見た目の賑やかす為の意味を有する装飾としての絵文字定義
- コミットメッセージの先頭に一つだけいずれかの絵文字を付与する。
全てのコミットメッセージに付与することが望ましいが厳守はしない。
- 後からの修正が利かないコミットメッセージに厳密性や完全性を求めても仕方が無いので、この絵文字にも厳密性や完全性は求めず簡潔さを優先する。
故に、一つの絵文字に限定し、複数の絵文字は付与しない。
- その時の気分で絵文字の選択が揺れるようなことを最小化する為に可能な限り明白な選択基準を定義する。
- コミットメッセージが絵文字の示す意味に依存しないこと。
絵文字を削除してしまっても困らないようなメッセージが望ましい。とは言え、そもそもコミットメッセージに厳密性・完全性がないのでそんなに深く気にしなくともよい。
- ドキュメントが主体なプロジェクトではドキュメントがコード扱いとなり、メタドキュメントがドキュメント扱いとなる。同様にリソースが主体なプロジェクトではリソースがコード扱いとなる。
- チームで開発してるプロジェクトに適用する際には反対意見に耳を貸すこと。
GUI ツールを使っている場合は良いがコマンドラインツールを使っている場合、絵文字は意図通りに表示されない。
- チームで開発してるプロジェクトに適用する際にはメンバーにフレーバー絵文字をつけることを強要しないこと。
- コマンドラインツールを使っているメンバーがいる場合にはダイレクトに絵文字を入力することは避け:emoji:形式で入力すること。
以下の順で、最初にヒットした絵文字を割り当てる。
新たな絵文字
新たな絵文字割り当てるのが相当と思われる場合は、適切と思われる絵文字を選択し、この選択基準にその選択条件を記述する。
- 📍
マイルストーン
リリースを示すコミットである。
- 🔬
些細な修正
修正対象がコードかドキュメントなどを問わず、あらゆるちょっとした修正。
- 🎲
トライアルアンドエラー
作業環境では動作確認できない為に行われる本来であればコミットされるべきでない未確認のコミット。
- 📚
多重なコミット
本来であれば複数のコミットに分かれているべきコミット。
マイルストーン
のような重要な内容を含む場合はそちらの絵文字を使用すること。 - 🔥
重大な悪影響のリスク
- 💉 動作確認が取れていない修正、アンドキュンメンテッドな挙動に依存してる修正
- ⛩
どうしてこれで正常に動作するのか不明の修正
正常に動作する確認はとれているがどうしてそのコードで正常に動作するのか不明な修正
- 🚀
パフォーマンス向上
- 💄
見た目の改善
- 💃
挙動の改善
UI/UX 周りの挙動の改善
- 📈
計測
- 🍒
マージ
- 💸
コミットの取り消し
- 🚫
機能の削除
- 🎚
調整
- 👔
警告の除去
- ♻️
リファクタリング・清書・整理
リファクタリング・清書・整理
の結果、機能の削除
やパフォーマンス向上
となるケースもあるが、基本的にはその修正の目的がリファクタリング・清書・整理
であるならばリファクタリング・清書・整理
とする。ただし、ちょっとしたリファクタリング・清書・整理
を行った結果、大きなパフォーマンス向上
となった場合はパフォーマンス向上
を適用すること。 - 🛡
セキュリティ
セキュリティ関連の機能追加や修正全般。ただし、セキュリティが悪化するような類いの修正であれば
重大な悪影響のリスク
あたりの絵文字の使用を検討すること。 - 💫
依存モジュールのアップデート
依存しているモジュール・ライブラリ等のアップデート及び、それに追従する為のコード修正。
- 🚧
開発環境絡みの問題
- 🎚
設定
- ☔️
問題の回避やその影響の軽減
問題を直接的には解決できてないが回避策や影響軽減策などを施したもの。基本的には根本的が修正・対策がなんらかの形で別途行われるべきモノ。
- 🦋
バグ修正
他の絵文字として表現されないバグ修正。
新たな絵文字
を割り当てるべきバグと思われる場合はそれを割り当てること。 - 🚥
仕様変更
- ⚖️
ライセンス
- 📝
ドキュメント
- ⚗
サンプル
(コード、データ等々) - 🎨
リソース
- 📊
データ
- 🍽
メタコード
- 🛠
実装
- ⚰
開発終了
- gitmoji | An emoji guide for your commit messages
- gemoji/emoji.json at master · github/gemoji
- Emoji cheat sheet for GitHub, Basecamp and other services
- GitHub で絵文字入りコミットメッセージを活用しているプロジェクトを調べてみた – プログラミング生放送
- dannyfritz/commit-message-emoji: Every commit is important. So let's celebrate each and every commit with a corresponding emoji!