3 points par GN⁺ 2024-10-20 | Aucun commentaire pour le moment. | Partager sur WhatsApp
  • Se concentrer sur les décisions

    • Une citation de Every Page Is Page One a provoqué un changement majeur dans l’approche de la rédaction de documentation technique
    • Dans la communication technique, on parle surtout d’aide à l’exécution des tâches, mais dans bien des cas, les informations dont les gens ont besoin pour accomplir une tâche ne concernent pas le fonctionnement de la machine, mais l’aide à la prise de décision
    • Le simple fait de documenter les procédures ne suffit pas
    • Il faut indiquer quelles décisions l’utilisateur doit prendre et quelles en seront les conséquences, puis l’orienter autant que possible vers des ressources et références qui l’aident à décider

Résumé de GN⁺

  • Cet article souligne l’importance de l’aide à la prise de décision dans la rédaction de documentation technique
  • Il est nécessaire d’aller au-delà de la simple description des procédures pour aider les utilisateurs à prendre de meilleures décisions
  • Pour les rédacteurs techniques, il est important de fournir aux utilisateurs le contexte et les informations dont ils ont besoin
  • Parmi les projets du secteur aux fonctionnalités similaires, Confluence et Notion sont recommandés

Aucun commentaire pour le moment.

Aucun commentaire pour le moment.