Transformer un enregistrement d'écran en guide pas à pas.

Partez d'une tâche complète.

Un bon guide a un point de départ clair et un résultat visible. « Inviter un collègue » donne au lecteur une tâche à accomplir. « Visite de nos paramètres » lui présente une série d'écrans sans raison de s'en servir.

Avant d'enregistrer, notez à qui s'adresse le guide, de quelle autorisation le lecteur a besoin et ce qu'il doit voir à la fin. Gardez ces réponses sous les yeux pendant que vous capturez le processus.

Relisez la narration avant de générer le guide.

À l'oral, on n'explique pas une tâche comme dans des instructions écrites. On peut faire une digression, se corriger ou dire « cliquez sur celui-là ». Votre script relu doit nommer les commandes et expliquer les actions dans l'ordre.

Dans Polysh, corrigez les noms de produits et les libellés des boutons avant de générer le guide. Gardez le contexte utile, mais séparez-le des actions que le lecteur doit réellement effectuer.

Vérifiez l'action, la capture d'écran et le résultat.

Polysh transforme la narration relue en étapes regroupées, prérequis, remarques et résultats attendus. Considérez le guide généré comme un brouillon à relire.

• Action : l'étape indique-t-elle quoi faire en utilisant le nom de la commande visible ?
• Capture d'écran : montre-t-elle l'écran dont le lecteur a besoin à ce moment-là ?
• Résultat : le lecteur peut-il savoir si l'action a fonctionné ?

Une étape avec la mauvaise capture d'écran prête à confusion. Si le guide généré n'a pas d'image adaptée, choisissez parmi les captures proposées ou laissez-la de côté jusqu'à avoir la bonne. Vérifiez les informations sensibles avant de partager.

Publiez une référence vraiment utilisable.

Téléchargez le guide relu en PDF ou partagez-le avec le public visé. Pour un guide qui accompagne une vidéo, gardez le même objectif même si la formulation diffère : la vidéo explique le parcours, le guide aide à le suivre.

Quand le processus change, mettez à jour le script et relisez à nouveau le guide. Régénérer le guide remplace ses modifications pour les langues sélectionnées : conservez les modifications manuelles importantes avant de le régénérer.