Vidéo ou documentation écrite : quand enregistrer, quand rédiger

Toutes les équipes finissent par avoir le même débat. Quelqu’un dit « enregistre juste une petite vidéo », quelqu’un d’autre répond « ça devrait être un document », et la tâche reste en suspens une semaine pendant que chacun attend un verdict.

La réponse n’est pas qu’un format serait meilleur que l’autre. C’est que la vidéo et le texte échouent à des endroits différents. La vidéo est imbattable pour montrer le mouvement, la séquence et le jugement. Le texte est imbattable pour être parcouru, recherché et corrigé. Choisissez mal, et vous enterrez une réponse de deux lignes dans un enregistrement de huit minutes — ou vous passez un après-midi à décrire un glisser-déposer en prose.

Ce guide vous donne une méthode reproductible pour décider en une trentaine de secondes, avant de commencer.

Le test des trente secondes

Posez trois questions sur ce que vous voulez documenter.

1. Est-ce que ça bouge ? Si comprendre suppose de voir quelque chose se produire — un trajet de curseur, une transition d’état, une animation, un outil qui réagit en temps réel — enregistrez.
2. Quelqu’un aura-t-il besoin d’un élément précis plus tard ? Si les gens reviendront chercher une valeur, une option ou une étape en particulier, rédigez. Personne ne fait défiler une timeline pour trouver un numéro de port.
3. À quelle fréquence cela change-t-il ? Si l’écran change tous les mois, le texte coûte moins cher à maintenir. S’il reste stable un an, la vidéo est rentable.

Deux réponses « vidéo » : enregistrez. Deux réponses « texte » : rédigez. Un partage égal signifie que vous avez sans doute besoin des deux — plus simple qu’il n’y paraît, comme expliqué plus bas.

Quand la vidéo l’emporte

Montrer un flux de travail entre plusieurs outils. Le difficile, dans la plupart des processus, n’est pas un clic isolé : c’est ce qui se passe entre les applications. Un enregistrement capture tout le parcours sans que vous ayez à décrire six changements de contexte.

Tout ce qui relève du jugement visuel. « Rends les espacements plus équilibrés », « cette animation est trop rapide », « le graphique doit respirer davantage ». Impossible à spécifier précisément par écrit, évident en dix secondes de vidéo.

Rapports de bug et reproductions. Un enregistrement montre la séquence exacte, le timing exact et l’état exact. Il supprime tout l’aller-retour du « je n’arrive pas à reproduire ».

Intégration et premières impressions. Les nouveaux arrivants ont besoin de voir à quoi ressemble l’aisance : à quelle vitesse une tâche devrait aller, où une personne expérimentée hésite, ce qu’elle ignore. Des étapes écrites aplatissent tout cela.

Tout ce que vous expliqueriez trois fois à l’oral. Si vous avez dit la même chose dans trois réunions, il faut un enregistrement, pas une quatrième réunion.

Transmettre le ton. Les retours, les décisions nuancées et tout ce qui pourrait paraître sec passent bien mieux avec une voix et un visage.

Quand l’écrit l’emporte

Le matériel de référence. Valeurs de configuration, paramètres d’API, raccourcis clavier, codes d’erreur. Tout ce que l’on consulte plutôt que l’on apprend.

Tout ce qui doit être trouvable. Le texte est indexé par votre wiki, votre centre d’aide et les moteurs de recherche. Une vidéo est une boîte noire tant qu’elle n’a pas de transcription.

Les étapes qui changent souvent. Modifier une ligne dans un document prend quelques secondes. Réenregistrer un segment, raccorder l’audio et réexporter prend une heure — et chaque image obsolète entame la confiance dans toute la bibliothèque.

Le contenu consulté pendant la tâche. Personne ne veut mettre en pause, rembobiner et relancer une vidéo d’une main pendant qu’il lance une migration de l’autre. Les check-lists sont faites pour être lues.

Juridique, conformité et tout ce qui exige une formulation exacte. Si la précision compte plus que la clarté : rédigez, faites relire, versionnez.

Le contenu très traduit. Le texte se traduit à faible coût en quatorze langues. Réenregistrer une voix off, non.

Le format dont la plupart des équipes ont vraiment besoin

La meilleure documentation est rarement l’un ou l’autre. C’est un court enregistrement posé sur une colonne vertébrale écrite.

Un schéma fiable :

• Une page écrite comme source de vérité. Titre, objectif, prérequis, étapes numérotées et toutes les valeurs exactes en texte copiable.
• Un enregistrement de deux à quatre minutes intégré en haut de page. Il montre la forme générale de la tâche pour que le lecteur sache ce qui l’attend.
• Des marqueurs de chapitre et des horodatages, pour que la vidéo devienne navigable au lieu d’être linéaire.
• Une transcription ou des sous-titres, pour rendre le contenu recherchable et accessible.

Ceux qui veulent l’idée générale regardent. Ceux qui cherchent une valeur parcourent. Aucun des deux groupes n’est pénalisé.

Gardez les enregistrements assez courts pour rester justes

La principale raison pour laquelle une documentation vidéo se périme, c’est sa longueur. Un enregistrement de vingt minutes couvrant huit sujets doit être entièrement refait dès qu’un sujet change. Huit enregistrements de trois minutes se remplacent un par un.

Des règles pratiques pour garder une vidéothèque maintenable :

• Une vidéo, un résultat. Si le titre a besoin d’un « et », scindez-la.
• Visez moins de cinq minutes. La plupart des explications de processus tiennent en trois.
• N’enregistrez pas ce qui change le plus vite. Tarifs, dates, noms d’équipes et textes d’interface ont leur place dans le texte à côté de la vidéo.
• Annoncez la version à voix haute ou affichez-la. « Enregistré en version 4.2 » transforme une vidéo périmée en vidéo datée, ce qui est bien moins dommageable.
• Enregistrez proprement. Mode Ne pas déranger activé, données de démonstration plutôt que dossiers clients réels, un thème cohérent. Un clip réutilisable à trois endroits vaut mieux que trois clips inutilisables ailleurs.

Réduisez le coût de l’enregistrement

La plupart des décisions « écrivons-le plutôt » signifient en réalité « enregistrer ressemble à une production ». Baisser ce coût change le calcul pour toute l’équipe.

• Sautez l’introduction. Commencez sur l’écran qui compte. Une documentation interne n’a pas besoin de quinze secondes de préambule.
• N’écrivez pas un script mot à mot. Notez cinq points et parlez. Les scripts donnent l’impression qu’on lit et triplent le temps de préparation.
• Corrigez en coupant, pas en réenregistrant. Supprimez les blancs, la phrase ratée et le long temps de chargement. Presque toutes les prises sont récupérables.
• Utilisez le zoom plutôt que la narration. Un zoom sur le bouton cliqué remplace la phrase qui explique où il se trouvait.
• Une bonne prise suffit. Une documentation interne n’a pas besoin d’une quatrième tentative. Publiez-la.

Une règle d’équipe simple

Pour clore ce débat, écrivez quatre lignes :

1. Référence et configuration → texte. Toujours.
2. Flux de travail, démos et retours → vidéo. Moins de cinq minutes.
3. Tout ce qui sert pendant une tâche → check-list écrite, avec un aperçu vidéo facultatif.
4. Tout ce qui change plus souvent que chaque trimestre → texte, sauf si le visuel est tout l’intérêt.

Ajoutez ensuite une règle plus importante que les quatre autres : chaque vidéo reçoit un titre écrit, un résumé d’une phrase et un lien depuis le document concerné. Un enregistrement que personne ne trouve est un enregistrement qui n’a pas eu lieu.

Pour conclure

Choisir un format n’est pas une préférence de style : c’est une décision de maintenance prise au nom de toutes les personnes qui liront votre travail dans six mois. La vidéo achète la compréhension. Le texte achète la durabilité. Les équipes qui documentent le mieux ne sont pas celles qui ont choisi un camp. Ce sont celles qui ont cessé d’en débattre, ont enregistré ce qui méritait d’être vu, écrit ce qui méritait d’être consulté, et relié les deux.