Passer au contenu principal
Cette page présente les bonnes pratiques pour utiliser des captures d’écran, des GIF et des vidéos dans votre documentation.
Les captures d’écran, les GIF et les vidéos peuvent enrichir la documentation, mais exigent une maintenance continue à mesure que l’interface évolue. Utilisez-les avec parcimonie pour éviter des mises à jour inutiles. Principes clés :
  • Les médias doivent être complémentaires. Si un processus est clair en texte seul, évitez d’ajouter des visuels.
  • Garantissez l’accessibilité. Ajoutez un texte alternatif aux images, des sous-titres aux vidéos et des transcriptions pour le contenu audio. De nombreuses personnes utilisent des technologies d’assistance, et rendre le contenu accessible bénéficie à tous.
  • Équilibrez clarté et pérennité. Les changements fréquents d’interface peuvent rapidement rendre obsolètes les captures d’écran et les vidéos. Évaluez si l’effort de mise à jour est à la hauteur de la valeur ajoutée.

​
Quand utiliser des médias

  • Captures d’écran pour les tâches difficiles à expliquer avec des mots.
  • GIF à des fins promotionnelles et pour des flux de travail courts mais complexes.
  • Vidéos pour les concepts abstraits et les longs flux de travail.
Utilisez les médias avec parcimonie et à bon escient pour éviter une dette de documentation inutile. Bien utilisés, ils améliorent la compréhension sans alourdir la maintenance ni créer de barrières à l’accessibilité.