Title → Hero image → Intro → Overview → Multiple sections explaining each part → Tips/best practices → Closing
Common elements (use as needed, not required)
Hero image note: [Hero image: brief description for designer]
Bullet lists: For multiple related changes
Before/after: When showing improvements
"How to try it": When the feature isn't obvious to find
Tips section: For power-user features
"One more thing": For bonus announcements
Example: Simple improvement
# We improved readability on daily.dev
[Hero image: side-by-side comparison of old vs new typography]
Reading articles should feel effortless. We noticed some font sizes and spacing were making longer posts harder to read, so we fixed it.
We bumped up body text size, improved line spacing, and tweaked heading hierarchy. The result? Less squinting, more reading.
---
Let us know how it feels!
Example: Multi-part feature
# Our most powerful tool to stay informed. Ever.
[Hero image: the new feature in action]
Staying on top of tech news shouldn't feel like a full-time job. That's why we built something new.
## Here's what you get-**Smart summaries**: Get the key points without reading everything
-**Custom alerts**: Know immediately when topics you care about trend
-**Weekly digests**: Curated highlights delivered to your inbox
## Why you'll love it
[Deeper explanation of the value prop]
## How to try it
Head to Settings → Notifications to set it up.
---
We're excited to hear what you think!
Tips for Great Changelogs
Lead with the benefit - "You can now..." not "We added..."
Be specific - "Save 3 clicks" beats "Improved workflow"
