Changelog Writing

Write changelogs for humans, not machines. Follow the Keep a Changelog convention.

Format Rules

• File: CHANGELOG.md at project root
• Date format: ISO 8601 (YYYY-MM-DD)
• Latest version first (reverse chronological)
• One entry per version, every version documented
• Follow Semantic Versioning
• Version headings are linkable (comparison URLs at bottom)

Change Categories

Group changes under these headings, in this order: