Diffvideo/Docs

Video Types

Diffvideo generates four types of videos, each optimized for a different audience and communication goal. The video type sets tone, structure, and focus for the finished cut.

Changelog

Changelog videos summarize what changed in a release or set of changes. They're structured as a list of updates — new features, improvements, and bug fixes — presented in user-friendly language.

  • Audience: Users, customers, the public
  • Tone: Professional, user-focused, benefit-oriented
  • Trigger: Release tags, scheduled summaries, or PR merges
  • Best for: Product changelogs, release announcements, customer communication

Changelog output prioritizes user-facing changes and filters out internal refactors, dependency updates, and infrastructure changes. The narrative focuses on benefits rather than implementation.

Product update

Product update videos provide a broader view of product evolution. Unlike changelogs which list individual changes, product updates tell a story about where the product is heading and what recent progress means for users.

  • Audience: Stakeholders, leadership, investors, users
  • Tone: Strategic, narrative, forward-looking
  • Trigger: Scheduled (weekly, sprint-cadence), release milestones
  • Best for: Sprint recaps, stakeholder updates, investor communication

Feature demo

Feature demo videos focus on a single feature or capability. The result walks through what the feature does, how it works, and why it matters, rather than reading like a flat changelog entry.

  • Audience: Users, prospects, developer communities
  • Tone: Educational, detailed, practical
  • Trigger: Feature-branch merges, PR merges with specific labels
  • Best for: Feature launches, marketing content, onboarding

Helpdesk

Helpdesk videos are designed for customer support communication. They focus on explaining changes from the customer's perspective — what was broken, what's now fixed, and what the customer can do differently.

  • Audience: Support teams, customers with open tickets
  • Tone: Empathetic, solution-focused, action-oriented
  • Trigger: Bug-fix PR merges, specific file path changes
  • Best for: Support updates, bug-fix communication, proactive outreach
Video type is configured per rule in the Rules Engine. You can have multiple rules for the same repository with different video types — e.g., a changelog video for release tags and a feature demo for feature-branch merges.

Choosing the right type

Use this as a guide for selecting video types in your rules:

  • Shipping to users? → Changelog
  • Updating stakeholders? → Product update
  • Launching a feature? → Feature demo
  • Fixing a reported bug? → Helpdesk

Next steps