La nouvelle Norme internationale ISO/IEC 26514:2008 aidera les concepteurs et développeurs de la documentation dans l'intérêt des utilisateurs de logiciels.
La norme définit le processus de documentation du point de vue de ceux qui la développent. Elle en couvre les phases de conception, de spécification et de production. Elle s'applique à la fois à la documentation imprimée et à la documentation sur écran.
L'ISO/IEC 26514:2008, Ingénierie du logiciel et des systèmes — Exigences pour les concepteurs et les développeurs de la documentation de l'utilisateur, couvre la conception, la spécification et la production de la documentation. Elle comporte deux parties:
- La première partie traite du processus de création de la documentation pour les concepteurs et les développeurs. Elle décrit comment établir, présenter, préparer et mettre à disposition l'information nécessaire aux utilisateurs. Ne se limitant pas à la phase de conception et de développement, elle inclut les activités dans l'ensemble des processus de gestion et de documentation des informations.
- La seconde partie définit des exigences minimales pour la structure, le contenu informatif et le format de la documentation, notamment pour les documents imprimés et à l'écran utilisés dans l'environnement de travail par les utilisateurs de systèmes contenant des logiciels. Elle s'applique aux manuels imprimés, à l'aide en ligne, aux didacticiels et à la documentation de référence à l'intention des utilisateurs.
La norme recommande que l'élaboration de la documentation soit intégrée au développement du produit logiciel, en suive les mêmes processus sur tout le cycle de vie et ne constitue pas un développement distinct.
La documentation destinée aux utilisateurs demeure une composante essentielle des logiciels d'application et l'ISO/IEC 26514:2008 peut constituer une aide pour développer les types suivants de documentation :
- documentation de produits autres que des logiciels;
- systèmes multimédias ayant recours à l'animation, à la vidéo et au son;
- documentation de formation informatisée et matériels de cours spécialisés destinés principalement à des programmes de formation officiels;
- documentation produite pour les installateurs, les opérateurs d'ordinateurs ou les administrateurs systèmes qui ne sont pas des utilisateurs finals;
- documentation de maintenance décrivant le fonctionnement interne des logiciels systèmes;
- documentation incorporée dans l'interface utilisateur elle-même.
L'ISO/IEC 26514 est la première d'une suite de normes prévues sur la documentation destinée aux utilisateurs de logiciels. Alors que l'ISO/IEC 26514 a été élaborée pour traiter des besoins des concepteurs et développeurs de la documentation, trois autres normes sont en préparation et traiteront des besoins des managers, des acheteurs et des fournisseurs ainsi que des professionnels chargés de la mise à l'essai et de l'évaluation de la documentation.
L'ISO/IEC 26514:2008 – Ingénierie du logiciel et des systèmes — Exigences pour les concepteurs et les développeurs de la documentation de l'utilisateur, a été élaborée par le comité technique mixte ISO/IEC JTC 1, Technologies de l'information, sous-comité SC 7, Ingénierie du logiciel et des systèmes. Il est disponible au prix de 216 francs suisses auprès des instituts nationaux membres de l'ISO (voir la liste complète et les coordonnées) et du Secrétariat central de l’ISO sur l'ISO Store ou en contactant le département Marketing & Communication (voir colonne de droite).
