Un outil de création d'aide ou HAT est un logiciel utilisé par les écrivains techniques pour écrire des aides et manuels.
Une documentation conviviale est une victoire pour le rédacteur technique. Mais en créer une peut être difficile, surtout pour un public varié, géographiquement distant, et parlant diverses langues. Voici des principes de rédaction technique qui peuvent vous aider chaque fois que vous essayez d'écrire un matériel d'aide convivial.
Une documentation pour logiciel efficace aide les utilisateurs du logiciel à comprendre ses fonctionnalités, ses fonctions et à exécuter des tâches spécifiques. Pour les rédacteurs techniques, la question est de savoir comment le faire exactement, tout en écrivant pour des utilisateurs avec très peu ou pas de connaissances techniques ? Découvrons comment !
Aimeriez-vous que votre site Web soit agréable avec une plus riche et étonnante expérience utilisateur sur tous les appareils, toutes les plates-formes et tailles d'écran ?
Il est facile de conclure que vous avez besoin d'un tel site Web du fait des utilisateurs de smartphones et tablettes. Point final. Mais vous devez aller au-delà des appareils actuels et imaginer les dispositifs à venir comme les montres connectées, Google Glass, la réalité virtuelle et augmentée, ou tout autre dispositif innovant que les experts high-tech peuvent lancer. Les sites Web adaptatifs et le développement fonctionneront pour eux aussi. Voyons combien les sites Web HTML adaptatifs sont importants.
Vous avez créé un produit presque parfait ou conçu un excellent logiciel. Et vous avez embauché ensuite certains des meilleurs rédacteurs techniques pour rédiger un manuel d'aide convivial pour résoudre les problèmes de convivialité. Vous voulez que les utilisateurs de vos produits pour en profitent dès la première minute. Les rédacteurs techniques ont fait un excellent travail, confirmé par votre équipe d'expérience utilisateur.
Mais après le lancement de votre produit ou la publication d'une mise à jour, vous dépensez beaucoup plus en assistance clientèle. Dans de nombreux cas, les réponses que les utilisateurs cherchent figurent dans le manuel de l'utilisateur. Alors vous vous posez désormais la même question que de nombreux fabricants et développeurs. Les utilisateurs du produit lisent-ils vraiment les manuels d'aide?
Choisir le bon format de publication pour vos fichiers d'aide peut être difficile, surtout si vous créez votre premier manuel et souhaitez éviter les énormes erreurs faites par les auteurs de manuel d’aide à leurs débuts. Le bon format détermine si vos utilisateurs ont accès à vos fichiers d’aide exactement quand et tel qu’ils le souhaitent.
Si vous utilisez un outil de création de manuel d'aide (et vous devriez parce qu'il facilite la rédaction des meilleurs documents d'aide en peu de temps), la publication dans différents formats peut se faire sans aucune difficulté.
La grande question à laquelle nous répondrons aujourd'hui est, devez-vous publier un manuel imprimé (copie papier) ou une édition numérique (PDF, CHM, HTML Web, format eBook...).
Quelle est la pire erreur que vous puissiez faire en tant qu' auteur de manuel d'aide débutant?
Un bon manuel d'aide se doit d'être pratique et contenir des instructions claires que les utilisateurs puissent trouver et utiliser facilement. Mais si vous êtes un auteur débutant, la création d'un bon manuel d'aide peut s'avérer une tâche difficile, surtout s'il s'agit de votre premier projet de rédaction technique.
Il est intéressant de savoir que tout bon rédacteur de manuel d'aide a débuté un jour et qu'il a lui aussi fait plusieurs erreurs lors de sa première tentative. Nous avons donc compilé ces erreurs afin que vous puissiez ne pas les reproduire. C'est une chance de pouvoir ainsi apprendre de ces erreurs et créer un manuel d'aide remarquable dès votre première tentative.
Reconnaissons-le, la documentation d'aide a aujourd'hui une terrible image. Presque tout ceux à qui vous parlez à ce sujet ont une mauvaise image des manuels d'aide. Il y a de nombreuses raisons à cela, les plus courantes étant:
Beaucoup d'auteurs de manuels d'aide ont découvert que les outils de création d'aide ou programmes logiciels HAT sont un excellent moyen pour rédiger rapidement et facilement les manuels et autres documents d'aide. Peu de gens prennent le temps de s'arrêter pour réfléchir à la manière dont les logiciels HAT avantagent effectivement tout le monde, aussi bien le fabricant du produit qui paye le manuel, que l'utilisateur final du produit.
Microsoft Word est un excellent logiciel. Il permet à ses utilisateurs de rédiger rapidement et facilement n'importe quel texte, du devoir scolaire jusqu'au courrier professionnel. Le plus grand avantage avec Microsoft Word c'est la familiarité d'usage qu'en ont ses utilisateurs, c'est un logiciel avec lequel la plupart d'entre nous avons grandi en l'utilisant aussi bien à l'école qu'au bureau. Pour beaucoup de gens, il reste le choix le plus naturel quand il s'agit d'écrire quoi que ce soit dans un environnement professionnel. Et dans la plupart des cas, Microsoft Word est idéal, mais il y a pourtant certaines applications, incluant la rédaction de documentation d'un produit, pour lesquelles il n'est pas si adapté que ça.
Il existe de nombreuses raisons qui font que Microsoft Word n'est pas le bon outil pour vous aider à rédiger la documentation d'un produit, voici cinq de celles-ci.
Tout le monde ou presque a au moins une horrible histoire liée à un manuel d'aide à raconter. Qu'il s'agisse d'essayer de comprendre un produit quand le manuel d'aide est écrit dans un si mauvais Français qu'il est illisible, ou qu'un produit ait simplement été livré avec le manuel d'un autre modèle. Ou peut-être l'histoire concerne-t-elle l'un de ces manuels qui sont si détaillés qu'ils contiennent trop d'informations et qu'il est presque impossible de trouver la réponse dont vous avez rapidement besoin. Il existe beaucoup de raisons pour qu'un manuel d'aide soit mauvais, mais en général, elles peuvent être divisées en deux principales catégories...
