Rapport - Département Informatique

3.6.4 Documentation et mise en forme du livrable
Un des points importants de notre TER était de faire quelques choses de facilement
utilisable et compréhensible par d’autres personnes. Pour ce faire, nous avons attaché un
soin particulier à la rédaction de la documentation et à la mise en forme de l’application
dans sa version finale.
Documentation utilisateur
Pour rendre l’application plus ergonomique, nous avons écrit une documentation utilisateur
expliquant le fonctionnement du portail. Cette documentation est déclinée en
plusieurs versions (une par type d’utilisateur). Elle permet de comprendre comment utiliser
les fonctionnalités de l’application. L’annexe 1 permet de voir à quoi ressemble cette
documentation utilisateur.
Mise en forme du livrable
Une fois le code nettoyé et commenté, nous avons créé un fichier .war contenant notre
portail. Ce fichier peut simplement être déposé dans un serveur Tomcat pour pouvoir
être utilisé. Néanmoins, pour que le portail fonctionne, la machine hébergeant le serveur
Tomcat doit posséder l’ensemble des applications utilisées par le portail (MySQL, vsftp,
Jenkins, etc.).
Documentation d’installation
Pour réduire la complexité d’installation des différentes applications utilisées par le portail
Web, nous avons écrit un tutoriel qui décrit les différentes étapes et technologies à installer
pour utiliser le portail. Cette documentation, plutôt technique, est réservé principalement
à l’administrateur du portail.
3.6.5 Ergonomie de l’IHM
Pour voir si l’application était ergonomique, nous avons fait tester le portail par deux
personnes. Ces utilisateurs (des étudiants volontaires), ont d’abords utilisé l’application
pendant une dizaine de minutes avant de répondre à un questionnaire de satisfaction. Ce
questionnaire est divisé en 3 parties :
– une partie A : dont le but est de noter le portail sur quelques critères.
– une partie B : dont le but est de noter les tests utilisateurs (utilité des tâches et
facilité de compréhension)
– une partie C : qui permet aux utilisateurs de donner leur avis (qualités, défauts,
fonctionnalités à ajouter, etc.)
Ensuite nous avons demandé aux utilisateurs d’exécuter quelques tâches afin de les chronométrer
pour s’assurer que les fonctionnalités étaient bien réalisables rapidement 10
10. Dans un contexte réelle d’étude d’interface, cette méthode permet de s’assurer que l’application
fait ce qu’on lui demande (efficacité) et qu’elle le fait dans un minimum d’effort (efficience).
21