- 機械的に生成するのではなく人間の手で書く
- 各セクションへのリンクが容易にできる
- 1つのバージョンごとに1つのサブセクションを作る
- リリースは新しいものが上に来るようにする
- 日付のフォーマットは YYYY-MM-DD で書く
- Semantic Versioning に従うかは明示的に表明する
- 各バージョンのセクションは次の原則に従うべき
- 上記のフォーマットの日付を付与する
- 以下のようにグループ分けして表記する
- Added 新機能
- Changed 既存機能の変更
- Deprecated 将来的に削除される機能
- Removed 削除された機能
- Fixed バグフィックス
- Security 脆弱性修正のためユーザーにアップデートを促す場合