¿Qué es un paso a paso verificado? La definición y cómo distinguirlo de una demo

Qué hace que sea verificado

Cuatro cosas, y las cuatro tienen que estar presentes. Si falta cualquiera de ellas, la grabación es una demo, que es un objeto distinto y menos útil.

• Una ejecución real. El producto se operó, frente a la cámara. Ni animado, ni generado, ni reconstruido a partir de capturas de pantalla.
• Evidencia del producto. El resultado se contrasta con algo que el producto produjo con independencia de la pantalla en la que se hace clic: un archivo en un bucket con una suma de comprobación que coincide, una alerta que llega a otra bandeja de entrada, una máquina restaurada que arranca.
• Los fallos se conservan. Todo lo que salió mal antes de que saliera bien se queda en el registro y en el video, con la solución.
• Una etiqueta de versión. Se registra la compilación en la que se ejecutó, para que el video se pueda volver a ejecutar cuando esa compilación cambie, en lugar de envejecer en silencio.

Lo que no cuenta

• Una demo. Un recorrido ensayado, hecho por alguien que ya sabía la respuesta. No tiene nada de falso, pero no es evidencia.
• Un video generado. Un modelo produjo imágenes a partir de un guion. Nunca estuvo limitado por lo que hace el software, así que no puede equivocarse, así que no verifica nada.
• Diapositivas narradas, útiles para conceptos, pero sin ningún producto en ejecución.
• Una grabación de pantalla enviada a una persona. Adecuada para un público de una sola persona que tiene el contexto. No indica versión, ni requisitos previos, ni evidencia.

Cómo distinguirlo de una demo en un minuto, más o menos

Seis preguntas. La mayoría de los videos de software, incluidos los caros, responden a una o dos.

• ¿Termina una tarea en un momento que puedas señalar?
• ¿Se indica la versión del producto?
• ¿Aparecen los requisitos previos en pantalla antes de hacer clic en nada?
• ¿Hay evidencia que produjo el producto, en lugar de un narrador que asegura que todo salió bien?
• ¿Se muestra algo que sale mal?
• ¿Puede quien lo ve actuar a partir de él: hay pasos escritos junto al video?

El filtro de publicación completo, de nueve puntos, está en qué hace bueno a un video de marketing para software, y un ejemplo práctico con sus dos fallos intactos es el paso a paso de instalación de Proxmox VE 9.2.

Por qué importan los fallos

La gente no busca “cómo configurar X”. Busca el mensaje de error, el paso que no funcionó, el ajuste que nadie documentó. Un paso a paso que contiene el fallo y la solución responde a esa búsqueda. Una demo pulida no la responde en absoluto, y por eso la respuesta acaba en un foro.

Preguntas

¿Un paso a paso verificado es lo mismo que una demo de producto?

No. Una demo muestra que una tarea se puede hacer, normalmente por alguien que ya sabía cómo hacerla. Un paso a paso verificado muestra que se hizo, en una versión indicada, contrastado con la evidencia del propio producto, con los intentos que fallaron todavía visibles.

¿Quién lo verifica?

Una persona. Un operador de IA ejecuta el producto; una persona contrasta el resultado con la evidencia del propio producto y decide si se puede publicar. No se publica nada sin revisar.

¿Qué pasa cuando el producto cambia?

Cada paso a paso indica la versión en la que se ejecutó. Cuando ese producto lanza una versión, las tareas afectadas por el registro de cambios se vuelven a ejecutar. Una nueva ejecución sin errores se vuelve a publicar; una fallida se señala con su registro.

¿Se puede verificar un video generado?

No. Un video generado nunca estuvo limitado por lo que hace el software, así que no hay nada con lo que contrastarlo. Puede ser una explicación precisa de hechos verificados en otro lugar, pero no es evidencia sobre el producto.