How we do changelogs
Contents
Our teams ship fast, and they ship whenever. The changelog is an important resource for users to keep up with what's new in PostHog.
Ownership
The content team (specifically, 
Edwin LimEdwin Lim and 
Vincent GeVincent Ge) writes changelog entries on a weekly basis and publishes them at the end of a week on the changelog page.
Changelog videos are produced by 
Jordo DibbJordo Dibb on a bi-weekly basis.
Collecting entries
To keep up with and stay out of the way of our fast moving product teams, we use automated workflows to collect changelog entries from merged GitHub PRs and feature flag rollouts.
| Type | Description | Link |
|---|---|---|
| Merged PRs | Catches GitHub info / pushes and processes | Relay workflow |
| Feature flag rollouts | Webhook sent when someone updates a flag | PostHog webhook |
| Feature flag rollouts | Relay workflow that catches the webhook and does the processing | Relay workflow |
These workflows publish to the #changelogs channel in Slack.
Content team's weekly changelog process
| Day | Task |
|---|---|
| Monday - Wednesday | Write up changelog entries that should be added to the website over the past week. With help from the video team, decide which of those entries are video worthy. |
| Thursday/Friday | Update PostHog's changelog page with new entries. |
| Thursday/Friday | Capture necessary screen recordings of that week's video entries and upload them for Jordo. |
Video team's bi-weekly changelog video process
Week one
| Day | Task |
|---|---|
| Monday | Jordo produces script based on changelog entries from the previous two weeks |
| Monday/Tuesday | Content team reviews the script and suggests changes |
| Tuesday/Wednesday/Thursday | Video production |
| Thursday | Draft video reviewed (1 round of amends) |
| Friday | Final edits |
Week two
| Day | Task |
|---|---|
| Monday | Publish video to: - HogTok (in-product) - Bluesky - YouTube shorts / main video - James personal accounts |
| Monday - Friday (both weeks) | Help content team with determining which entries should be included in next video |
Future plans
The cadence of changelogs and changelog videos is likely to change in the future as we figure out our rhythm. Changelogs might also be surfaced in different ways in-app or in the product docs.