Evaluating Vendor Documentation

Abstract

The documentation provided with an automated system should outline all necessary procedures; answer questions; help with staff training; and provide a comprehensive and detailed view of the purchased system. Good documentation does not offer irrelevant information, nor does it present too much detail when inappropriate, or too little when required. The hazards of inadequate documentation are many—it can be misleading, erroneous, and confusing. Good documentation cannot make up for a poor system; and poor documentation is not likely to result in a good system being rejected by a potential purchaser. However, in addition to training staff and end‐users to effectively use a new system, good documentation can help decision‐makers understand the features, functionality, and advantages of a good system.

La fonctionnalité des images dans des manuels visant l’apprentissage d’un logiciel de dessin, selon les critères de concision, de consistance et de cohérence

“…Certains auteurs (Weiss, 1991;Duin, 1989b;Wood, 1989) déplorent le fait que les documents d'accompagnement sont souvent négligés et qu'on y retrouve encore trop d'inconsistance et d'incohérence par rapport au texte. Les résultats de la présente recherche semblent confirmer que ces lacunes existent également en ce qui concerne l'image.…”

“…Notons également que les iconèmes polysémiques sont davantage ceux qui véhiculent les signifiés relatifs à la précision de points et à la précision sur le temps. Comme le montrent les travaux de certains auteurs (Shneiderman, 1992;Reisner, 1990;Duin, 1989b;Wood, 1989;Thomas et Schneider, 1984), l'absence de cohérence, de consistance ou de concision risque d'entraver la compréhension que le lecteur a du message. Voici les principaux résultats de notre analyse.…”