Qu'est-ce qu'un pas-à-pas vérifié ? La définition, et comment le distinguer d'une démo

Ce qui en fait un pas-à-pas vérifié

Quatre éléments, et les quatre doivent être présents. S'il en manque un seul, l'enregistrement est une démo, un objet différent et moins utile.

• Une exécution réelle. Le produit a été piloté, devant la caméra. Ni animé, ni généré, ni reconstitué à partir de captures d'écran.
• Des preuves issues du produit. Le résultat est confronté à quelque chose que le produit a créé indépendamment de l'écran sur lequel on clique : un fichier dans un bucket avec une somme de contrôle correspondante, une alerte qui arrive dans une autre boîte de réception, une machine restaurée qui démarre.
• Les échecs conservés. Tout ce qui a mal tourné avant que cela fonctionne reste dans le journal et dans la vidéo, avec la solution.
• Une étiquette de version. La version utilisée lors de l'exécution est consignée, si bien que la vidéo peut être réexécutée quand cette version change, au lieu de vieillir en silence.

Ce qui ne compte pas

• Une démo. Un parcours rodé, déroulé par quelqu'un qui connaissait déjà la réponse. Rien de faux là-dedans, mais ce n'est pas une preuve.
• Une vidéo générée. Un modèle a produit des séquences vidéo à partir d'un script. Elle n'a jamais été contrainte par ce que fait le logiciel, donc elle ne peut pas se tromper, donc elle ne vérifie rien.
• Des diapositives commentées, utiles pour les concepts, mais sans aucun produit en fonctionnement.
• Un enregistrement d'écran envoyé à une seule personne. Adapté à un public d'une seule personne qui connaît le contexte. Il ne comporte ni version, ni prérequis, ni preuve.

Comment le distinguer d'une démo en une minute environ

Six questions. La plupart des vidéos de logiciels, y compris les plus coûteuses, répondent à une ou deux d'entre elles.

• Une tâche se termine-t-elle, à un moment que vous pouvez désigner ?
• La version du produit est-elle indiquée ?
• Les prérequis sont-ils à l'écran avant le moindre clic ?
• Y a-t-il une preuve issue du produit, plutôt qu'un narrateur qui affirme la réussite ?
• Voit-on quelque chose mal tourner ?
• Un spectateur peut-il s'en servir : des étapes écrites à côté de la vidéo ?

La grille complète en neuf points à valider avant publication se trouve dans ce qui fait une bonne vidéo marketing pour un logiciel, et un exemple concret, avec ses deux échecs intacts, est le pas-à-pas d'installation de Proxmox VE 9.2.

Pourquoi les échecs comptent

Les gens ne cherchent pas « comment configurer X ». Ils cherchent le message d'erreur, l'étape qui n'a pas fonctionné, le paramètre que personne n'a documenté. Un pas-à-pas qui contient l'échec et la solution répond à cette requête. Une démo léchée n'y répond pas du tout, et c'est pourquoi la réponse finit plutôt sur un forum.

Questions

Un pas-à-pas vérifié est-il la même chose qu'une démo produit ?

Non. Une démo montre qu'une tâche peut être réalisée, généralement par quelqu'un qui savait déjà comment faire. Un pas-à-pas vérifié montre qu'elle a été réalisée, sur une version indiquée, confrontée aux preuves issues du produit lui-même, avec les tentatives qui ont échoué toujours visibles.

Qui le vérifie ?

Une personne. Un opérateur IA pilote le produit ; un humain confronte le résultat aux preuves issues du produit lui-même et décide s'il est publiable. Rien n'est publié sans vérification.

Que se passe-t-il quand le produit change ?

Chaque pas-à-pas porte la version sur laquelle il a été exécuté. Quand ce produit sort une nouvelle version, les tâches touchées par le journal des modifications sont réexécutées. Une réexécution sans accroc est republiée ; une réexécution échouée est signalée avec son journal.

Une vidéo générée peut-elle être vérifiée ?

Non. Une vidéo générée n'a jamais été contrainte par ce que fait le logiciel : il n'y a donc rien à quoi la confronter. Elle peut expliquer fidèlement des faits vérifiés ailleurs, mais elle ne constitue pas une preuve sur le produit.