Gestion des sorties de produits : le retour d’expérience de SoftFluent – 7/12
juin 14, 2012 Poster un commentaire
Documentation du logiciel
Notre processus de documentation est très étroitement lié à notre processus de développement.
Immédiatement après avoir développé une fonctionnalité, nous rédigeons la partie concernée de la documentation. Pour cela nous utilisons Innovasys HelpStudio et nous générons la documentation de référence en utilisant DocumentX. Toutefois, pour automatiser au maximum, nous avons aussi écrit un outil personnalisé (DocMaker CodeFluent) pour créer les fichiers concernant tous les schémas XML utilisés par le produit.
Tout cela fonctionne bien dès l’instant où vous avez la bonne discipline de développement en mettant les commentaires à l’endroit approprié dans les fichiers de code.
La documentation est générée en tant que :
· Fichier .CHM,
· fichier HXS,
· PDF d’environ 1.000 pages,
· Et publiée directement sur notre site.
Nous avons de plus décidé de rendre publique notre documentation pour 2 raisons :
• Nous voulons que tous les développeurs voient les possibilités très étendues de notre produit,
• Nous bénéficions de l’indexation Google, les développeurs CodeFluent Entities peuvent facilement trouver les réponses aux sujets CodeFluent Entities en faisant des recherches "plein-texte" sur Google ce qui est naturel pour un développeur.
