Blog

Ship it, then say it well.

Guides to changelogs, release announcements, docs and developer relations, for teams that build developer tools.

An og:image card reading 1200 x 630, with the 1.91:1 ratio for Facebook and LinkedIn, 2:1 for X's large card and a file size under 5 MB
Launch posts

OG Image Size: Open Graph Dimensions for Every Platform

The OG image size that works everywhere: 1200x630 at 1.91:1. Official Facebook, LinkedIn and X sizes, file limits, the meta tags and how to fix previews.

Read the guide
A version number, 2.4.1, with the next major, minor and patch versions and the kind of change each one means
Git

Semantic Versioning (SemVer): Rules, Ranges and Examples

SemVer explained: when to bump major, minor or patch, 0.x and 1.0.0, pre-releases, sort order, npm caret and tilde ranges, the regex, and CalVer.

Two Reddit and Hacker News mentions of Acme turned into a new-mention alert
Community

Reddit Monitoring Tools Compared (Plus Hacker News)

F5Bot, KWatch.io, Syften, Octolens, Brand24, Awario, RedShip and more: sources, alerts, reply drafting and prices, plus free ways to monitor Reddit.

A phone's What's New panel for an Acme update with a headline line, then New, Improved and Fixed
Release notes

App Release Notes: App Store and Google Play Templates

How to write app release notes for the App Store and Google Play: each store's limits and rules, six templates with examples, fastlane files, a checklist.

A product update email with a subject line naming the change, preview text and a Try it button
Release notes

Product Update Email Template: 6 Examples to Copy

Six product update email templates to copy or download: feature launch, monthly update, fixes, price change, breaking change and upgrade, with examples.

A merged pull request turned into an X post and a LinkedIn post, each waiting for approval
Launch posts

Tools That Turn GitHub PRs Into X and LinkedIn Posts

ShipPost, Merge & Tell, Shipstar, DevRelay and xpost compared: what starts a draft, what the AI reads, whether it posts for you, and what it costs.

LinkedIn post format: a post with its hook above the see more cut, short paragraphs, a list and a link
Launch posts

LinkedIn Post Format: Specs, Layout and 6 Templates

How to format a LinkedIn post: the 3,000-character limit, the "see more" cut, line breaks, bold text, image sizes and six announcement templates.

Terminal showing git commit --amend and git rebase -i with a commit marked reword
Git

How to Change a Git Commit Message (Last, Old or Pushed)

Change the last commit message with git commit --amend, an older one with git rebase -i and reword, a pushed one with --force-with-lease. With examples.

What is DevRel: content, code, community and feedback between a company and developers
DevRel

What Is DevRel? Developer Relations Explained

DevRel (developer relations) explained: the four parts of the work, job titles, how to get into DevRel, how to measure it, and where DevRel people learn.

Changelog examples: an update with a headline feature, then Improved and Fixed lines labelled by area
Changelogs

Changelog Examples: 11 Real Changelogs and What to Copy

11 real changelog examples from Linear, Stripe, GitHub, Vercel, Raycast, Tailwind and more: how each is built, the idea worth copying, and a checklist.

Three kinds of changelog tool: hosted (you write it, they deliver it), Git-based (commits in, a version out) and AI drafting (reads the PRs, writes the entry)
Changelogs

Best Changelog Tools in 2026: 17 Compared by Type

17 changelog tools compared: hosted pages and widgets, Git-based generators and AI tools that draft from GitHub, with prices, free plans and how to choose.

A conventional commit message, feat(inbox): add send later for replies, with its type, scope and description labelled
Changelogs

Conventional Commits Cheat Sheet: Types, Examples, Rules

Every Conventional Commits type with examples, how to pick one, breaking changes, footers, version bumps and changelog sections, and how to enforce it.

A release notes template with a title, summary, and New, Improved and Fixed sections
Release notes

Release Notes Template: 8 Copy-Paste Formats with Examples

A software release notes template with a sample, plus eight to copy or download: SaaS update, email, API, app store, GitHub, internal, hotfix and Jira.

A changelog entry with Breaking, Added and Fixed sections
Changelogs

How to Write a Changelog: Format, Examples and Template

What a changelog is, which format to use, how to group entries, how to word breaking changes, fixes and speed-ups, what to leave out, and a template.

An X post announcing a release, with a code snippet and a docs link
Launch posts

How to Announce a Product Release on X: 10 Post Formats

Ten X post formats for release announcements, matched to the kind of change (launch, feature, fix, performance, breaking), with templates and examples.

A changelog feeding release notes, which feed announcements
Changelogs

Release Notes vs. Changelog: What's the Difference?

A changelog is a running record for developers; release notes explain one release to users. What goes in each, where GitHub Releases fits, how to do both.

Commits flowing through a release tool into a changelog and a GitHub release
Changelogs

How to Automate Your Changelog From GitHub (5 Tools)

How changelog automation works, and how to set up GitHub's generated release notes, release-please, semantic-release, Changesets and git-cliff, compared.

Code releases moving ahead of the docs version
Documentation

Docs Drift: How to Keep Documentation in Sync With Your Code

Why docs drift from code, how to find the drift you have, and what stops it: docs next to code, tested examples, generated reference and CI checks.

The DevRel loop: ship, announce, document, listen
DevRel

DevRel for Startups: How to Do It Without a DevRel Hire

What DevRel means at a startup: the ship-announce-document-listen loop, a two-hour weekly cadence, what to skip, and when to hire a developer advocate.

Let the next release write its own changelog.

DevRelay drafts the changelog entry, the posts and the docs update when you ship. You approve what goes out.

No credit card · Nothing posts without your approval