Obsolescence de l'information
Lorsqu'on publie une documentation sur un produit en évolution, il est fréquent que ce qui est vrai à un instant t ne le soit plus quelques temps plus tard, il faut donc faire un effort de remise à jour et sur une grosse publication on fait parfois des oublis.
Je vais prendre un cas concret qui est à l'origine de ma reflexion, il m'arrive de mettre à disposition des composants entre 2 versions d'Help&Web voir d'en faire un tutorial, comme celui sur l'affichage d'un flux rss, en surveillant mes logs de connexion je constate que certaines personnes téléchargent les composants alors qu'ils sont présents dans la version actuelle d'Help&Web.
En relisant le tutorial en question effectivement rien n'indique qu'il n'est plus utile de télécharger le composant...
Pour éviter cela on pourra utiliser la compilation conditionnelle, elle est maintenant capable de réagir au numéro de version de la documentation.
Spécifier un numéro de version
En encadrant les sections qui ne seront plus valables lors de la version suivante on évite d'avoir à remodifier son travail.
télécharger la toute dernière version de travail
Imprimer