Quel est le meilleur logiciel à utiliser pour rédiger un manuel d’utilisation technique ?


Cela dépend vraiment de votre public, de votre objectif et du contenu/longueur.

Si vous rédigez de courts mémos, des guides de référence ou des notes de mise à jour pour les développeurs et les ingénieurs, alors MS Word fera très bien l'affaire, surtout s'il s'agit d'un document de 10 ou 20 pages.


En revanche, plus le document est long, plus MS Word commence à devenir problématique et coûteux en raison des problèmes bien connus de séquences de numérotation et du manque de pages maîtresses. Un document Word de mille pages, par exemple, peut tout à coup gâcher votre numérotation des paragraphes au milieu de la page 500. Le corriger peut devenir une affaire de fou, car la numérotation Word est très sensible aux sauts de section et de page qui courent tout au long d'un document Word typique. Vous corrigez la numérotation à un endroit et vous pensez avoir terminé jusqu'à ce que vous découvriez que vos numéros ont dérapé dans un autre coin du même document.


Un autre problème avec Word est son manque de fonctionnalité intégrée de source unique. Il existe des applications tierces comme SmartDocs qui vous permet de générer plusieurs livrables à partir d'un seul ensemble de fichiers sources, mais vous devez également utiliser SharePoint pour pouvoir le faire.

Un logiciel plus intégré et plus robuste serait quelque chose comme Adobe FrameMaker ou Flare. Je n'ai pas personnellement utilisé Flare mais j'ai toujours entendu de bonnes choses à son sujet dans notre communauté de rédaction technique.

J'ai des décennies d'expérience avec FrameMaker et je peux dire avec certitude que vous pouvez générer des documents de MILLIERS de pages avec FM et qu'il fournira toujours des résultats fiables et fiables. Il est construit sur un paradigme de page maître, de sorte que vous pouvez passer d'un modèle de page à un autre en l'affectant simplement à la page de votre choix. Ensuite, vous pouvez générer un fichier d'aide (HTML) à partir de celui-ci facilement en utilisant son application sœur RoboHelp.

Pour la correspondance et la documentation au bureau, MS Office et Word feraient très bien l'affaire. Mais pour générer de longs documents techniques avec des tableaux, des listes et des modèles de page changeants, j'opterais soit pour FrameMaker+RoboHelp, soit pour Flare.

Les documents techniques peuvent être générés à partir d'un fichier HTML.