什么是经验证的实操演示?定义,以及如何把它与演示区分开
经验证的实操演示,是真实产品在干净的环境中完成一个明确给定任务的录制视频:结果对照产品自身产生的证据进行核验,失败的尝试保留在日志中,视频标注了运行时所针对的版本,以便在该版本变化时重新运行。
怎样才算经过验证
四个条件,而且四个都必须具备。缺少其中任何一个,这段录制就只是演示,而演示是另一种东西,用处也更小。
- 真实运行。产品被实际操作,全程录屏。不是动画,不是生成的,也不是根据截图重建的。
- 来自产品的证据。结果要对照产品在被点击的界面之外独立产生的东西来核验:存储桶里校验和一致的文件,另一个收件箱里收到的告警,恢复后能够启动的机器。
- 失败都被保留。成功之前出过的任何问题,都连同解决方法一起保留在日志和视频中。
- 版本标签。记录运行时所针对的构建版本,这样构建变化时视频可以重新运行,而不是悄无声息地过时。
哪些不算
- 演示。由早已知道答案的人,沿着排练好的路径完成。它没有任何虚假之处,但它不是证据。
- 生成的视频。由模型根据脚本生成画面。它从未受到软件实际行为的约束,所以不会出错,所以也验证不了任何东西。
- 配旁白的幻灯片,适合讲解概念,但没有运行任何产品。
- 发给某一个人的录屏。适合了解背景的单个观众。它没有版本、没有前提条件,也没有证据。
如何在一分钟左右把它与演示区分开
六个问题。大多数软件视频,包括花大价钱制作的软件视频,只能回答其中一两个。
- 任务是否在一个可以明确指出的时刻完成?
- 是否注明了产品版本?
- 在点击任何东西之前,前提条件是否已经展示在屏幕上?
- 是否有产品产生的证据,而不是旁白声称成功?
- 是否展示了出错的情况?
- 观众能否照着做:视频旁边是否有文字步骤?
完整的九项发布前检查见《什么样的软件营销视频才算好视频》;保留了两次失败的完整示例,见 Proxmox VE 9.2 安装实操演示。
为什么失败很重要
人们不会去搜“如何设置 X”。他们搜的是报错信息、没有成功的那一步、没人写进文档的那个设置。包含失败和解决方法的实操演示,正好回答这类搜索。精心打磨的演示则完全回答不了,这也是为什么答案最终出现在了论坛上。
常见问题
经验证的实操演示和产品演示是一回事吗?
不是。演示展示的是一个任务能够完成,通常由早就知道怎么做的人来操作。经验证的实操演示展示的是这个任务确实完成了:在注明的版本上,对照产品自身的证据核验,失败的尝试依然可见。
由谁来验证?
由人来验证。AI 操作员运行产品;再由人对照产品自身的证据核验结果,并决定是否可以发布。任何内容都不会未经核验就发布。
产品变化后会怎样?
每个实操演示都标注了它运行时所针对的版本。该产品发版时,变更日志涉及的任务会重新运行。顺利的重跑会重新发布;失败的重跑会连同日志一起被标记出来。
生成的视频能被验证吗?
不能。生成的视频从未受到软件实际行为的约束,所以没有可以对照核验的东西。它可以准确讲解在别处已经验证过的事实,但它不是关于产品的证据。
看一个实例,包括它的运行日志和失败的尝试。
$ cd /library →