Demo freshness guide
Keep Interactive Product Demos Current
Detect which demo scenes changed with the product, preserve audience branches, and verify the approved current version reached every destination.
To Keep Interactive Product Demos Current, connect each scene to the Product Journey checkpoint, declared context, source Observation, and approved Rendition that support it. When the Journey Version changes, evaluate only the affected scenes and verify every delivered demo version.
Re-recording the whole demo on a schedule creates work without proving truth. Updating a date or swapping screenshots without evidence creates fake freshness.
Build a scene dependency map
For each scene record:
- owning Journey and immutable version;
- semantic checkpoint;
- actor, role, plan, locale, theme, viewport, data, and flag context;
- source Observation hash;
- presentation transformation;
- narration, caption, transcript, hotspot, branch, and call-to-action dependencies;
- approving Decisions;
- demo and Publication versions;
- destinations and receipts.
A single scene can appear in several audience branches. Reuse one source relationship instead of copying maintenance state.
Detect material product change
Compare current and prior Journey definitions, State Capsules, and Observations. Demo impact includes changed prerequisites, authority, sequence, visible state, terminology, error recovery, accessibility semantics, side effects, or product outcome.
A backend refactor with identical supported behavior may require a keep Decision. A small label change may affect captions, hotspot target text, transcript, localization, and search metadata even if the visual composition is stable.
Re-execute before editing
Run affected representative contexts. Retain functional evidence so the new scene reflects a working outcome. Retain visual, accessibility, state, target, privacy, and policy evidence where relevant. Classify failures before sending assets to the demo editor.
Do not update a demo from a failed Run or imported plausible screenshot. Bind the source through the supported evidence path.
Decide per scene and output
Choose:
- keep unchanged;
- refresh from new approved evidence;
- reframe for a changed audience or value story;
- merge duplicate scenes;
- redirect an audience branch;
- block an unsafe or false scene;
- retire an obsolete outcome.
Record why and preserve historical versions. An unaffected scene should not be regenerated merely to make the demo look uniformly new.
Preserve personalization boundaries
Dynamic variables and audience branches can alter names, logos, industry data, calls to action, and sequence. Keep personalization fictional or permissioned. Never imply customer usage, integration, or results from a template value.
Verify every branch whose product meaning differs. A base scene approved for an administrator does not establish validity for a member role or different plan.
Update every presentation layer
A changed scene can affect:
- screenshot or HTML clone;
- hotspot position and target;
- step text;
- narration and voiceover;
- captions and transcript;
- annotation and highlight;
- conditional branch logic;
- thumbnail and social preview;
- embedded collection;
- offline or exported copy.
Treat copied, downloaded, or exported artifacts as independent Publications unless the destination remains live-linked.
Review by subject
Product owners verify intended behavior. Marketing or enablement owners verify audience and story. Design owners verify presentation. Accessibility and privacy owners verify their subjects. Channel owners verify delivery.
The same agent that regenerated a demo cannot be its sole approver. Record exact Decisions and reopen them when source or policy changes.
Verify delivery
After publishing, request every important destination: direct link, website embed, help-center embed, in-app hub, offline package, or campaign page. Confirm version, content hash where possible, access policy, captions, interaction, and call to action. Retain receipts.
An editor save or upload response is not proof that viewers receive the approved current version.
Monitor useful metrics
Track scene lineage coverage, version alignment, current approved evidence, current delivery receipts, and stale-scene count. Demo engagement and conversion belong to the demo/analytics systems and should be used only when first-party attribution is connected.
Do not claim that faster asset generation improves conversion or adoption without evidence.
Monitor the destination platform
The demo platform can change rendering, embed behavior, privacy, analytics, or export formats while source product evidence remains correct. Monitor the served demo separately and classify viewer failures as Publication or Channel problems rather than regenerating the Journey.
Prevent demo sprawl
Before creating a new demo, check whether an existing audience intent can be updated or branched. Near-duplicates multiply stale scenes and analytics fragmentation. Create a separate demo only when audience, outcome, conversion, or delivery policy materially differs; otherwise merge and preserve one canonical owner.
Public discovery boundaries
Private, gated, or unlisted demos should remain non-indexable. When public search matters, maintain an owned canonical explanation page with a direct answer, transcript or visible explanation, stable URL, and product path. Never expose viewer data or private demo evidence for SEO.
Incident response
If a demo contains private data, fabricated UI, unsafe instructions, or unsupported claims, block delivery, revoke access where possible, preserve the incident, and inspect every derivative. Publish a correction only after new evidence and Review.
Document whether cached, embedded, offline, and exported versions can be revoked. When they cannot, publish a clear correction at the stable owned URL and contact authorized destination owners. Do not claim complete remediation until the audience-facing copies are verified.
Retain the incident timeline, affected versions, owners, and final verification receipts for later audit.
Example
An invitation Journey changes member permissions and moves the primary action on mobile. Administrator desktop scenes may need only a hotspot and screenshot refresh. Member-branch scenes need a story correction because the action is no longer permitted. Captions and transcripts need new terminology. An exported sales PDF becomes stale even if the live embed updates.
The system records refresh Decisions for affected scenes, a keep Decision for an unchanged outcome scene, and separate receipts for the live demo and PDF replacement.
Operating loop
- detect material Journey change;
- resolve scene dependencies;
- execute affected contexts;
- approve source evidence;
- decide per scene;
- regenerate and edit Renditions;
- complete subject Reviews;
- deliver every output version;
- verify destinations and receipts;
- monitor evidence and reopen on the next change.
Continue with Product Demo vs Product Journey, Launch Media from Approved Product Evidence, and the internal one Journey, multiple Renditions study.
Start with one release-critical Journey.
Define the outcome, declare its state, run it, inspect the evidence, and record the Decision before expanding coverage.