-
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.