O que é um passo a passo verificado? A definição e como diferenciá-lo de uma demo

O que o torna verificado

Quatro coisas, e as quatro precisam estar presentes. Se faltar qualquer uma delas, a gravação é uma demo, que é um objeto diferente e menos útil.

• Uma execução real. O produto foi operado diante da câmera. Não foi animado, nem gerado, nem reconstruído a partir de capturas de tela.
• Evidência do produto. O resultado é conferido com algo que o produto gerou independentemente da tela que está sendo clicada: um arquivo em um bucket com checksum correspondente, um alerta chegando em outra caixa de entrada, uma máquina restaurada que inicializa.
• As falhas mantidas. O que deu errado antes de dar certo fica no log e no vídeo, com a correção.
• Uma tag de versão. O build usado na execução fica registrado, para que o vídeo possa ser reexecutado quando esse build mudar, em vez de envelhecer em silêncio.

O que não conta

• Uma demo. Um caminho ensaiado, percorrido por alguém que já sabia a resposta. Não tem nada de falso, mas não é evidência.
• Um vídeo gerado. Um modelo produziu imagens a partir de um roteiro. Ele nunca esteve limitado pelo que o software faz, então não pode estar errado, então não verifica nada.
• Slides narrados, úteis para conceitos, mas sem nenhum produto em execução.
• Uma gravação de tela enviada a uma pessoa. Serve para um público de uma só pessoa, que tem o contexto. Não traz versão, nem pré-requisitos, nem evidência.

Como diferenciá-lo de uma demo em cerca de um minuto

Seis perguntas. A maioria dos vídeos de software, inclusive os caros, responde a uma ou duas.

• Alguma tarefa é concluída, em um momento que você consegue identificar?
• A versão do produto é informada?
• Os pré-requisitos aparecem na tela antes de qualquer clique?
• Há evidências geradas pelo produto, em vez de o narrador afirmar que deu certo?
• Aparece algo dando errado?
• Quem assiste consegue agir a partir dele: há etapas escritas ao lado do vídeo?

A checagem completa de nove pontos antes da publicação está em o que faz um bom vídeo de marketing para software, e um exemplo prático com as duas falhas intactas é o passo a passo da instalação do Proxmox VE 9.2.

Por que as falhas importam

As pessoas não pesquisam “como configurar X”. Elas pesquisam a mensagem de erro, a etapa que não funcionou, a configuração que ninguém documentou. Um passo a passo que contém a falha e a correção responde a essa busca. Uma demo polida não responde a ela de forma alguma, e é por isso que a resposta acaba ficando em um fórum.

Perguntas

Um passo a passo verificado é o mesmo que uma demo de produto?

Não. Uma demo mostra que uma tarefa pode ser feita, geralmente por alguém que já sabia como. Um passo a passo verificado mostra que ela foi feita, em uma versão informada, conferida com as evidências do próprio produto, com as tentativas que falharam ainda visíveis.

Quem faz a verificação?

Uma pessoa. Um operador de IA opera o produto; um ser humano confere o resultado com as evidências do próprio produto e decide se ele pode ser publicado. Nada é publicado sem conferência.

O que acontece quando o produto muda?

Cada passo a passo traz a versão em que foi executado. Quando esse produto lança uma nova versão, as tarefas afetadas pelo changelog são reexecutadas. Uma reexecução sem erros é republicada; uma que falha é sinalizada com o seu log.

Um vídeo gerado pode ser verificado?

Não. Um vídeo gerado nunca esteve limitado pelo que o software faz, então não há com o que conferi-lo. Ele pode explicar com precisão fatos verificados em outro lugar, mas não é evidência sobre o produto.