On this page
Every SaaS product needs a changelog. Most changelogs are afterthoughts: bullet lists dumped into a Notion page or a GitHub releases tab that nobody reads. The Keep a Changelog project established a community standard for structured changelogs, but most teams still ignore it. Wire treats release notes as content. Structured, searchable, citation-backed, and auto-updated.
The Pain Point
Changelogs decay into two failure modes. Either they stop updating (the team ships features but forgets to document them) or they become unreadable walls of "Bug fixes and improvements." Neither serves the user who needs to know what changed and why.
Dedicated changelog tools (Changelogy, Beamer, LaunchNotes) cost $29-199/month and lock you into their format. Your changelog lives on their domain, not yours. No SEO value. No AI discoverability. No integration with your developer documentation.
How Wire Fits
Wire's news pipeline is a changelog engine:
news: Monitors your product's GitHub, blog, and social channels for release announcementsrefine: Integrates updates into structured changelog entries with links to pull requests, documentation, and migration guidesnewsweek: Generates weekly summaries aggregating all changes across topics. Your "This Week in [Product]" report, automated- Build gates: Every changelog entry gets validated. Broken links to PRs, missing dates, thin entries. All caught
What to Customize
wire.yml
nav:
- index.md
- Changelog:
- Overview: changelog/index.md
Set extra.wire.refresh_days to match your release cadence. Daily deploys might refresh every 3 days. Monthly releases every 14.
Prompt Overrides
Create docs/changelog/_styleguide.md that teaches the AI:
- Lead with what changed for the USER, not the code
- Link every change to the relevant documentation page
- Include migration steps for breaking changes
- Use
:::alertfor deprecation notices
Components
Use :::recent 20 on the index page for a living changelog. Use :::tabs to separate changes by category (Features, Fixes, Breaking Changes). Use :::badges for version labels.
Scope
Wire generates RSS feeds so users can subscribe to your changelog, JSON-LD for rich search results, a search index, llms.txt so AI assistants know your latest features, and sitemap entries for every release. The same structured output that powers a product directory or a niche blog also powers your release notes.
Wire does not support inline release subscriptions (email notify on new release) or per-user changelog views (show what changed since their last visit). For notifications, pair with Buttondown or your existing email tool. Wire generates the content. Distribution is separate.
To get started, create docs/changelog/index.md with :::recent 20, configure news to monitor your product's update channels, and run python -m wire.chief news changelog followed by python -m wire.chief refine changelog to structure them. Set up the bot for automated weekly generation. See all Wire use cases for more patterns.