Treat the demo as a maintained product asset

Keep SaaS demos current by separating the stable explanation from changeable interface steps, recording which product version each video shows and assigning an owner to review it when releases ship. Update based on whether a change misleads the viewer, not whether every pixel still matches.

A new button colour may not justify a re-edit. A changed permission, renamed workflow or removed feature can. The expensive mistake is discovering the difference only after sales has sent an outdated link to a buyer. A demo library needs a maintenance decision, not an automatic full remake after every release.

    Separate the promise from the click path

    An explainer answers why a workflow matters. A guided demonstration shows what it does. A task tutorial teaches someone how to perform it. When all three are fused into one long film, a small interface change can disturb narration, pacing and graphics that were otherwise still useful.

    FDM’s Krista.ai work uses product and use-case storytelling; our TikaMobile work includes module-level product walkthroughs. These are useful examples of different layers of product education. They do not prove a particular maintenance saving, but they illustrate why one all-purpose video is not the only way to organise a library.

    For a new project, script the durable problem and outcome separately from version-sensitive screen instructions. Keep clean screen recordings, narration and graphic elements available as separate production assets. Confirm ownership and handover terms with your production partner rather than assuming editable files are included.

      Sources: FDM: Krista.ai product explainersFDM: TikaMobile product walkthroughs

      Make a small video register

      Start with a shared sheet, not a new platform. For every live film record its URL, audience, task, product version or capture date, owner, source project location and every place it is embedded. Include the approved transcript. A beautiful asset that nobody can locate or retire is not a maintained asset.

      Add one field that forces a useful decision: “What would make this video misleading?” For a permissions tutorial, the trigger might be a changed role requirement. For an overview, it might be a capability that is no longer available. This makes the review specific enough for a product manager to answer.

      • Asset ID and public URL
      • Task, audience and lifecycle stage
      • UI version or capture date
      • Owner and last review date
      • Change triggers and distribution locations
      • Source files, transcript and replacement status

      Triage releases before scheduling edits

      Illustrative scenario: the product moves “Reports” into “Analytics”, changes a chart colour and removes an export option. The colour change may be cosmetic. The navigation move can prevent a learner from following the tutorial. The removed export option makes the demonstrated capability inaccurate. These are three different priorities, even if they arrived in one release.

      Ask the product owner to review the relevant transcript and screen sequence against release notes. Retire or clearly replace materially misleading content promptly. Do not leave a wrong promise live while waiting to refresh every cosmetic detail. A short, accurate replacement can be preferable to an immaculate obsolete film.

        Write modules that can survive a small change

        Use one recognisable task per tutorial module and make the starting state explicit. Microsoft’s procedural writing guidance recommends task-focused headings and clear, separate actions. Applying that discipline to a script makes it easier to locate the exact instruction affected by a release.

        Leave useful editing boundaries around screen actions. Avoid a single uninterrupted camera move across five unrelated screens if those screens change independently. Do not hard-code temporary campaign language into a reusable UI demonstration. These are production recommendations, not a promise that every update will become a simple screen swap.

        A screen replacement can still alter timing, cursor position, narration or callouts. Check the complete exported sequence, not only the new clip. Watch once as a learner and once specifically for audio, captions and labels that still refer to the old interface.

          Sources: Microsoft: Writing step-by-step instructions

          Finish the update where people actually watch

          A new master export is not the end of the job. Replace the website embed, help article, sales link and learning-system version where applicable. Test that captions and thumbnails belong to the new version. If a platform preserves an existing URL when replacing media, verify that behaviour before relying on it.

          Review the register as part of release planning. For a fast-changing product, start with the most-used task videos and the highest-risk promises. You do not need to remake the whole library at once. You do need to know which videos remain dependable and who is responsible for the next decision.

            Sources and references

            Explore Software product education TikaMobile walkthroughs Software video content